Met onze data feeds API kan content uit het CMS opgehaald worden om bijvoorbeeld op je website (van een derde partij) getoond te worden.
Dit document beschrijft het gebruik van de Business Apps Data Feeds API. De Data Feeds worden aangeboden in JSON formaat. De API (.NET WCF) kan als REST API benaderd worden.
Wil je gebruik maken van de API? Vraag dan je gegevens op bij Business Apps service.
Specificaties
API endpoint
https://cms.concapps.nl:8095/Concapps.svc/
Authenticatie methode
HTTPS authenticatie
Beschikbare API methoden
Naam
GetContent
Omschrijving
Methode om data op te halen uit verschillende onderdelen van een app of site. Deze methode ondersteunt enkel “content” onderdelen. Het is niet mogelijk om uit alle onderdelen data te halen op deze manier. Overleg hierover met Business Apps service.
Request
AppSecret – API key behorend bij de app waarvan de data opgehaald word. Business Apps service levert deze.
SectionId – ID van onderdeel waarvan de data opgehaald moet worden. Deze is app specifiek en kan in overleg met Business Apps service verstrekt worden.
BranchId - Indien de app meerdere vestigingen bevat wordt de BranchId gebruikt om hier op te filteren.
Result
Een Content array / list van data. Dit kunnen verschillende soorten content objecten zijn, dit is afhankelijk van het type van het onderdeel (section) waar de data van opgehaald wordt. Deze data kan verwerkt worden op de gewenste manier.
Let op! Dit is geen copy / paste oplossing, er zit geen opmaak of styling in deze data, dit is ruwe data bedoelt om in een bestaande omgeving te integreren.
Voorbeeld result velden van object in array bij section type News:
"__type" : NewsContentObject:#Concapps.Logic.TypedContent "AppId" : APPID VAN APP
"Body" : “Body tekst van content item”
"Branch" : Hoofdvestiging
"ContentType" : 100 "ContentTypeStr" : News "Highlighted" : false
"ImageUrl" : URL van afbeelding "IsNarrowcasting" : false "Name" : Naam
"PublishDate" : \/Date(1474869821000+0000)\/
"SectionId" : ID van section "SubTitle" :
"Title" : Titel van content
Voorbeeld code (PHP)
<?php
$username = "GEBRUIKERSNAAM";
$password = "WACHTWOORD";
$url = "https://cms.concapps.nl:8095/Concapps.svc/GetContent";
$appkey = "API KEY";
$section = "SECTION ID";
$post_data = array(
'request' => array(
'AppSecret' => $appkey,
'SectionId' => $section
)
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data) ); curl_setopt($ch, CURLOPT_USERPWD, $username . ":" . $password); curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); $output = curl_exec($ch);
$json_output = json_decode($output, true);
foreach($json_output["GetContentResult"]["Content"] as $r) {
echo $r['Title'];
}
//PRINT DE GEHELE ARRAY
//print_r($json_output);
curl_close($ch);
?>
Met het resultaat van deze data kunnen verschillende dingen gedaan worden zoals sorteren, bewerken en filteren van de data. Dit is afhankelijk van het platform waarin de API geïmplementeerd wordt en is volledig aan de ontwikkelaar om dit te implementeren.