La documentation de l'API est en cours de rédaction
API theatre-contemporain.net et theatre-video.net
spectacles → Dates et lieux de représentation pour ce spectacle → exemples & codes
- type d'objet éditorial →
spectacles - type de données en sortie →
spectacles - valable pour le site →
https://www.theatre-contemporain.net - requête complète →
https://www.theatre-contemporain.net/api/spectacles/OBJET/schedules
Résultats pour l'objet "STOP-ou-Tout-est-bruit-pour-qui-a-peur"
Appel de la fonction jQuery
<script type="text/javascript">
$('#list-spectacles').thnetSpectacleSchedule({
apiRequest: '/api/spectacles/OBJET/schedules', // Requête (OBJET = identifiant unique)
start: '0', // Debut de l'offset
end: '5', // Fin de l'offset
apiKey: 'VOTRE_CLE_API', // Clé API
entryPoint: 'https://www.theatre-contemporain.net', // Point d'entrée
});
</script>PHP avec cURL
$apiRequest = '/api/spectacles/OBJET/schedules'; // Requête (OBJET = identifiant unique)
$start = '0'; // Debut de l'offset
$end = '5'; // Fin de l'offset
$apiKey = 'VOTRE_CLE_API'; // Clé API
$entryPoint = 'https://www.theatre-contemporain.net'; // Point d'entrée
// initialiser CURL et définir les options
$apiCall = curl_init($entryPoint.$apiRequest.'?k='.$apiKey);
$apiCallOptions = array(
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array('Content-type: application/json'),
);
curl_setopt_array($apiCall, $apiCallOptions);
// récupèrer les résultats
$result = json_decode(curl_exec($apiCall));
// faire un print des résultats
echo '<pre>'.print_r($result,true).'</pre>';
Données renvoyées au format JSON
Astuce : pour obtenir un JSON "organisés" pour vos débugages, ajoutez le paramètre
?json_pretty_print ou
?json_pretty_print=JSON_UNESCAPED_SLASHES
Schéma
Array
(
[properties] => Array
(
[title] => Array
(
[type] => string
[description] => Titre du spectacle
)
[object] => Array
(
[type] => string
[description] => URL permanente du spectacle
)
[dates] => Array
(
[type] => object
[description] => Dates, horaires et lieu de représentation
[objects] => Array
(
[date] => Array
(
[type] => string
[description] => Date de représentation
)
[hours] => Array
(
[type] => object
[description] => Horaires de représentation
[objects] => Array
(
[hour] => Array
(
[type] => string
[description] => Horaire de représentation
)
)
)
[location] => Array
(
[name] => Nom du lieu
[city] => Ville
[object] => Identification unique de l'objet lieu/contact
[permanent_url] => URL permanente de l'objet lieu/contact
[url_spectacle] => URL du spectacle sur le site Internet du lieu/contact
)
)
)
)
)