Endpoint - /articles/{id}
Haal de details van een artikel op. Er zijn vier typen artikelen (verhalen, tipverzamelingen, recepten en reisverslagen) en niet alle velden zijn relevant voor alle typen. In de voorbeeldrespons hieronder zijn alle velden compleet gevuld, in werkelijkheid zal dit niet voor kunnen komen. Tips komen alleen voor bij artikelen van het type tipverzameling
Calls
| Endpoint | Beschrijving |
|---|---|
| get/articles/{id} | Haal de details van een enkel artikel op |
Voorbeeld response
{
"article": {
"id": "308",
"url": "http://some.example.com/verhalen/308/op-reis/",
"canonical": "http://twente2018.other.example.com/Artikelen/308/op-reis/",
"image": "http://other.example.com/img/15310/DSC_6046.jpg",
"ovv_image": "http://other.example.com/img/7518/DSC_5963.jpg",
"typeid": "4",
"type": "Reisverslag",
"is_advertorial": "",
"author_name": "Hendrik Met achternaam",
"author": {
"id": "3",
"image": "http://other.example.com/img/16370/DSC_1113.JPG",
"firstname": "Hendrik",
"infix": "",
"lastname": "Met achternaam",
"email": "foo@bar.nl",
"phone": "",
"description": "Hoi ik schrijf dingen om mee te testen. Doei."
},
"title": "OP reis met een verslag",
"subtitle": "En ondertiteling",
"video": "embed://youtube/eXMTHIDoxiE",
"videotitle": "Finkers!",
"description": "Fugit pariatur amet fugiat sit. Possimus qui debitis et in vel. Dolorem tempore ...",
"html": "<!--B:TEXT-->\n<p>Aut quae veritatis dolore. Iusto quis pariatur est ...",
"html_src": "Aut quae veritatis dolore. Iusto quis pariatur est molestias nobis ut. Eos dolor...",
"steps_html": "<!--B:TEXT-->\n<p>Id illum assumenda repellendus qui consequatur dolo...",
"steps_src": "Id illum assumenda repellendus qui consequatur dolor ex. Quas quasi voluptas est...",
"suggestion_html": "<!--B:TEXT-->\n<p>Beetje maggi erbij. Esse fuga suscipit blanditiis r...",
"suggestion_src": "Beetje maggi erbij. Esse fuga suscipit blanditiis repellat ea. Molestiae iste si...",
"topics": [
{
"id": "220",
"name": "Onderwerp",
"title": "Onderwerp",
"subtitle": "Dit is een gewoon onderwerp",
"video": "",
"description": "Dit onderwerp is niet aan plaatsnamen gekoppeld. We laten een tip zien en een in...",
"content_html": "<!--B:TEXT-->\n<p>Eos cum quo aliquid. Eveniet libero voluptate id de...",
"content_src": "Eos cum quo aliquid. Eveniet libero voluptate id deserunt facere et numquam. Sin...",
"iconclass": "",
"image1": "http://other.example.com/img/7514/DSC_6001.jpg",
"image2": "http://other.example.com/img/14547/DSC_6021.jpg",
"image3": "http://other.example.com/img/8885/DSC_5985.jpg",
"cities": "",
"is_article_filter": "",
"is_landing_page": "1"
},
{
"id": "221",
"name": "Enschede",
"title": "Enschede",
"subtitle": "Stad van nu",
"video": "embed://youtube/3T8ZLpCjEJk",
"description": "Quod qui exercitationem quo earum. Repudiandae ut ea ipsam assumenda voluptas oc...",
"content_html": "<!--B:TEXT-->\n<p>Voluptatibus et dicta sint fugit quidem. Magnam sap...",
"content_src": "Voluptatibus et dicta sint fugit quidem. Magnam sapiente repellat iusto quia non...",
"iconclass": "Accomodation",
"image1": "http://other.example.com/img/8890/DSC_5986.jpg",
"image2": "http://other.example.com/img/8865/DSC_6000.jpg",
"image3": "",
"cities": "Enschede\nUsselo\nBoekelo",
"is_article_filter": "",
"is_landing_page": "1"
}
],
"tipcount": "3",
"show_tip_numbers": "1",
"tips": [
{
"type": "location",
"locationid": "11547",
"routeid": "0",
"eventid": "0",
"dealid": "0",
"link": "/andere-groep/11547-buurse-erven-ed/",
"title": "Buurse Erven ED",
"image": "http://other.example.com/img/8913/DSC_6044.jpg",
"video": "",
"html": "<p>Volledig gerenoveerde luxueuze vakantieappartement, met eigen ingang, d...",
"html_src": "Volledig gerenoveerde luxueuze vakantieappartement, met eigen ingang, deel uitma..."
},
{
"type": "route",
"locationid": "0",
"routeid": "408",
"eventid": "0",
"dealid": "0",
"link": "http://some.example.com/routegroep/408/hanzestadswandeling-kampen/",
"title": "Hanzestadswandeling Kampen",
"image": "http://other.example.com/img/18799/img.jpg",
"video": "",
"html": "<p>Kampen heeft, net als elke Hanzestad, zijn eigen authentieke sfeer en c...",
"html_src": "Kampen heeft, net als elke Hanzestad, zijn eigen authentieke sfeer en charme! \nH..."
},
{
"type": "manual",
"locationid": "0",
"routeid": "0",
"eventid": "0",
"dealid": "0",
"link": "",
"title": "Handmatige tip met markdown",
"image": "http://other.example.com/img/8912/DSC_6124.jpg",
"video": "",
"html": "<!--B:TEXT-->\n<p>Corporis molestias quia non <strong>sapiente&...",
"html_src": "Corporis molestias quia non **sapiente** molestiae laboriosam veritatis explicab..."
}
],
"travelogue": [
{
"order": "0",
"title": "Maandag",
"html": "<!--B:TEXT-->\n<p>Occaecati cum temporibus enim reprehenderit iure. N...",
"html_src": "Occaecati cum temporibus enim reprehenderit iure. Nisi dolores exercitationem el...",
"activities": [
{
"time": "10:00",
"latlong": "52.222386000,6.893611000",
"lat": "52.222386",
"long": "6.893611",
"title": "Zo dan",
"html": "<!--B:TEXT-->\n<p>HopHop</p>",
"html_src": "HopHop"
},
{
"time": "11:00",
"latlong": "52.235370000,6.914958000",
"lat": "52.23537",
"long": "6.914958",
"title": "En even wandelem",
"html": "<!--B:TEXT-->\n<p>Ducimus itaque aut id beatae quis et. Nam est repel...",
"html_src": "Ducimus itaque aut id beatae quis et. Nam est repellat temporibus provident nemo..."
},
{
"time": "13:00",
"latlong": "52.254144200,6.158511400",
"lat": "52.2541442",
"long": "6.1585114",
"title": "Lekker snacken",
"html": "<!--B:TEXT-->\n<p>Nu gaan we lunchen. Nomnomnom. Hebben we daar ook f...",
"html_src": "Nu gaan we lunchen. Nomnomnom. Hebben we daar ook foto's van?\n\n<!-- EMBE..."
}
]
},
{
"order": "2",
"title": "Dinsdag",
"html": "<!--B:TEXT-->\n<p>Nog een dag om te testen</p>",
"html_src": "Nog een dag om te testen",
"activities": [
{
"time": "09:00",
"latlong": "52.740177900,6.077977900",
"lat": "52.7401779",
"long": "6.0779779",
"title": "Activiteit",
"html": "<!--B:TEXT-->\n<p>Om te doen</p>",
"html_src": "Om te doen"
},
{
"time": "12:00",
"latlong": "52.251839400,6.154097900",
"lat": "52.2518394",
"long": "6.1540979",
"title": "Er is zoveel te doen",
"html": "<!--B:TEXT-->\n<p>Lala, met een lees meer component</p>\n\n<!-...",
"html_src": "Lala, met een lees meer component\n\n<!-- EMBED :: 22 :: Lees ook eens -->\n\n..."
}
]
}
],
"pubdate": "2021-07-08T10:06:00+02:00",
"archivedate": "2021-07-08T10:06:00+02:00",
"lastmodified": "2021-07-12T11:49:17+02:00"
}
}
Details velden
- id
- [int] Het ID van het artikel
- url
- Het adres van het artikel in de huidige site
- canonical
- Het canonical adres van het artikel (kan afwijken van url wanneer het artikel uit een andere site geimporteerd is)
- image
- Hoofdafbeelding van het artikel
- ovv_image
- Een foto die extra toegevoegd kan zijn voor gebruik in de overzichtsweergave. Deze is meestal geschikter voor vierkantere uitsnedes
- typeid
- Type id van het artikel
- type
- Artikeltype
- is_advertorial
- Betreft het een advertorial?
- author_name
- Naam van de auteur
- author
- Details van de auteur, de veldnamen spreken voor zich
- title
- Titel van het artikel
- subtitle
- Ondertitel
- video
- Externe video gecodeerd in een uri in de vorm embed://{service}/{videoid}. Service kan zowel youtube als vimeo zijn
- videotitle
- Titel / bijschrift voor bij de video
- description
- Inleiding / korte samenvatting van het artikel
- html
- De inhoud van het artikel in HTML opmaak
- html_src
- De inhoud van het artikel in Markdown opmaak
- steps_html
- alleen bij recept De te volgens stappen om het recept te maken, in HTML opmaak
- steps_src
- alleen bij recept De te volgens stappen om het recept te maken, in Markdown opmaak
- suggestion_html
- alleen bij recept Tip of suggestie om te varieren met het recept, in HTML opmaak
- suggestion_src
- alleen bij recept Tip of suggestie om te varieren met het recept, in Markdown opmaak
- topics
- Een array met alle onderwerpen gekoppeld aan de locatie. Zie het topics-endpoint voor een beschrijving van de velden
- tipcount
- alleen bij tipverzameling Aantal tips in de verzameling
- show_tip_numbers
- alleen bij tipverzameling Boolean die aangeeft of de tips genummerd mogen worden weergegeven, soms niet wenselijk omdat nummers een rangorde impliceren
- tips
- alleen bij tipverzameling Een array met de informatie over de tips. Elk tipobject heeft de volgende velden:
- tip > type
- Indicatie van het soort tip. Het kan een van de volgende types zijn:
event Er is een evenement gekoppeld.
location Er is een locatie gekoppeld.
route Er is een route gekoppeld.
special Er is een deal gekoppeld.
manual De inhoud is handmatig gevuld - tip > locationid
- ID van een eventueel gekoppelde locatie, hiermee kunnen via het locations/{id} endpoint details woren opgehaald.
- tip > routeid
- ID van een eventueel gekoppelde route, hiermee kunnen via het routes/{id} endpoint details woren opgehaald.
- tip > eventid
- ID van een eventueel gekoppeld evenement, hiermee kunnen via het events/{id} endpoint details woren opgehaald.
- tip > dealid
- ID van een eventueel gekoppelde deal, hiermee kunnen via het deals/{id} endpoint details woren opgehaald.
- tip > link
- Link naar meer informatie over deze tip
- tip > title
- Titel bij de tip
- tip > image
- Link naar de afbeelding bij deze tip
- tip > video
- Externe video gecodeerd in een uri in de vorm embed://{service}/{videoid}. Service kan zowel youtube als vimeo zijn
- tip > html / html_src
- Tekstinhoud van de tip in HTML / Markdown opmaak
- travelogue
- alleen bij reisverslag Een array met de informatie over de reis. Elk reisverslag bestaat uit een aantal dagen. Per dag
kunnen er activiteiten worden gedaan. Hieronder wordt de datastructuur uitgelegd:
- day > order<
- Volgorde van de dag binnen de set
- day > title
- Titel van de dag
- day > html / html_src
- Tekstinhoud van de reisdag in HTML / Markdown opmaak
- day > activities
- Activiteiten voor de dag in een array. Hieronder wordt een veldbeschrijving gegeven:
- day > activity > time
- Tijdstip HH:MM
- day > activity > latlong / lat / long
- Coordinaten van de locatie waar de activiteit plaatsvindt.
- day > activity > title
- Titel van de activiteit
- day > activity > html / html_src
- Tekstinhoud van de activiteit in HTML / Markdown opmaak
- pubdate
- Publicatiedatum in ISO 8601 formaat
- archivedate
- Archiefdatum in ISO 8601 formaat.
- lastmodified
- Modification date in ISO 8601 formaat