Introduction
L'Open API de Radio France permet aujourd'hui d'accéder de façon programmatique à la grille des programmes (ex : savoir quelle émission passe à quelle heure donnée sur une chaîne donnée) de toutes les chaînes du groupe, et à des informations sur les chaînes, émissions et podcasts.
Format
L'Open API de Radio France est au format Graphql. Nous vous conseillons au préalable de vous familiariser avec la syntaxe Graphql, décrite sur le site officiel GraphQL | A query language for your API
Premiers pas
Les appels à l'API se font via des requêtes POST à l'URL https://openapi.radiofrance.fr L'accès à l'Open API (ainsi qu'à sa documentation) est protégé par une clé, aussi appelée token d'API.
Pour demander une clé d'API :
- rendez-vous sur le portail https://developers.radiofrance.fr
- créez-vous un compte
- puis dans la section "mon compte", cliquez sur "demander une clé d'API". Vous devrez mentionner en quelques mots le nom de votre projet, ainsi que sa finalité. Votre demande sera alors traitée par nos équipes, et vous recevrez suite à cela votre clé d'API par email.
Pour tout appel à l'Open API vous devez passer cette clé :
- soit dans le header HTTP x-token
- soit en ajoutant le paramètre x-token à l'URL
La documentation est (sommairement) auto-documentée, à l'adresse suivante https://openapi.radiofrance.fr/v1/graphql?x-token=votre-token-d-api
Attention à bien remettre votre token d'API dans le champ URL de l'explorateur d'API