Radionomy - Board
https://board.radionomy.com/

FAQ - API (Liste des questions concernant les API)
https://board.radionomy.com/viewtopic.php?f=27&t=47
Page 1 of 2

Author:  LeTopTop [ Mon Jun 24, 2013 12:52 pm ]
Post subject:  FAQ - API (Liste des questions concernant les API)

FAQ - API (Liste des questions concernant les API)

Retrouvez ci-dessous la liste des questions posés concernant l'utilisation des API (Radionomy) :


Author:  LeTopTop [ Tue Jun 25, 2013 1:11 pm ]
Post subject:  1-Qu'est-ce qu'une API ?

1-Qu'est-ce qu'une API ?

Une API (Application Programming Interface) est un ensemble de méthode ou de fonction mettant à disposition un accès à certaines données afin que celle-ci puissent être utilisées par des logiciels tiers.

Author:  LeTopTop [ Tue Jun 25, 2013 1:16 pm ]
Post subject:  2-Dois-je avoir des connaissances pour utiliser les API ?

2-Dois-je avoir des connaissances pour utiliser les API ?

Un minimum de connaissance (HTML, PHP, etc.) est nécessaire afin de pouvoir utiliser les API. En effet, une mauvaise utilisation des api peux blacklister votre ApiKey, rendant ainsi la récupération des données impossible.

(Si vous n'avez aucune connaissance dans ces différents langage de programmation et que vous souhaité malgré tout pouvoir afficher le titre en cours sur votre site, cliquez-ici)

Author:  R-One [ Fri Jul 26, 2013 8:18 pm ]
Post subject:  3-Quels sont les API que Radionomy met à ma disposition ?

3-Quels sont les API que Radionomy met à ma disposition ?

Radionomy met à votre disposition 6 Api différentes :

-API Current Song : Vous permettant d'afficher la pochette ainsi que le titre en cours de diffusion.
|
-API Current Audience : Vous permettant d'afficher sur votre site le nombre d'auditeurs à l'écoute de votre radio.
|
-API Tracklist : Vous permettant d'afficher sur votre site les derniers titres (jusqu'à 50) ayant été diffusés sur votre radio.
|
-API Top Tracks : Vous permettant d'afficher sur votre site, les titres les plus diffusés sur votre antenne.
|
-API Radio News : Vous permettant d'afficher les dernières news de votre radio publiées sur le site.
|
-API Baracoda* : Vous permet de fournir à OrangeLive ou RadioMee les infos (XML) concernant votre radio.

*L'API Baracoda ne doit être utilisé/traité d'aucune façon de votre part, elle doit simplement être transmise lors de votre référencement.

Author:  R-One [ Fri Jul 26, 2013 8:27 pm ]
Post subject:  4-Y-a-t'il des pré-requis pour utiliser les API ?

4-Y-a-t'il des pré-requis pour utiliser les API ?

Afin de pouvoir utiliser les API (hormis API Baracoda), il vous est nécessaire :
-de disposer d'un hébergement internet de type dynamique (PHP5) mutualisé ou dédié.
-d'avoir à votre disposition l'identifiant unique de la radio concerné (RadioUid),
-d'avoir en votre possession la clé API (où se trouve mon ApiKey ?) vous permettant d'utiliser les différentes API,

Author:  R-One [ Fri Jul 26, 2013 8:32 pm ]
Post subject:  5-Où trouver mon RadioUid ?

Qu'est-ce que le RadioUid, d'une radio ?

Le radioUid est un identifiant individuel et unique à chaque radio. Ce code permet d'identifier avec précision toute radio diffusant sur la plate-forme Radionomy.

Quel différence avec la clé api (apikey) ?

Contrairement à votre clé api (apikey) qui est confidentielle et ne doit pas être communiquée à un tiers, votre "radiouid" peut être transmis sans cette précaution.

Où puis-je trouver le radioUid de ma radio ?

Chacune de vos radios (si vous en avez plusieurs) dispose donc de cet identifiant unique qui se trouve dans la partie "Settings > Information technique" (voir l'image ci-dessous).

Attachment:
File comment: Radio Uid Apikey
radiouid_apikey.jpg
radiouid_apikey.jpg [ 49.29 KiB | Viewed 20769 times ]

Author:  R-One [ Fri Jul 26, 2013 8:47 pm ]
Post subject:  6-Où trouver mon ApiKey ?

6-Où trouver mon ApiKey ?

Votre clé API (ApiKey) est disponible dans le RMO : Settings > Information technique (voir image ci-dessous) :

Attachment:
File comment: radio uid apikey
radiouid_apikey.jpg
radiouid_apikey.jpg [ 49.29 KiB | Viewed 20769 times ]


Avertissement : Votre clé API est unique, elle ne doit pas être partagée avec d'autres personnes. En cas de non-respect des limitations d'appels des différentes API, votre clé s'expose à un blacklistage DÉFINITIF.

Author:  R-One [ Fri Jul 26, 2013 9:04 pm ]
Post subject:  7-Je ne peux plus récupérer les informations fourni par les

7-Je ne peux plus récupérer les informations fournies par les API, pourquoi ?

Il est probable que votre ApiKey a été blacklisté.
Afin de garantir la stabilité et la réponse des API pour chacun des utilisateurs, il a fallu mettre des restrictions d'appels sur celles-ci.
C'est pour cela que l'ApiKey est blacklistée lorsque les appels ne respectent pas le schéma et les contraintes du nombre d'appel de chaque API.

Quote:
Les Api en quelques chiffres :
En moyenne Radionomy reçoit chaque jour 30,000,000 d'appels licites sur ses API, soit 1,25 millions par heure ou encore 350 appels par seconde. En pic, le nombre d'appel monte à 800 par seconde.
En laissant passer les appels illicites, les serveurs reçoivent près de 180,000,000 appels au total, dont plus de 150,000,000 d'appels illicites...

Author:  R-One [ Fri Jul 26, 2013 9:07 pm ]
Post subject:  8-Mon ApiKey est-elle blacklisté ?

8-Mon ApiKey est-elle blacklisté ?

Lorsque votre clé API (ApiKey) est bloquée (blacklisté) par Radionomy, l'API vous retourne alors une redirection de type 301 vers votre propre adresse IP.

Author:  R-One [ Fri Jul 26, 2013 9:12 pm ]
Post subject:  9-Comment débloquer mon ApiKey ?

9-Comment débloquer mon ApiKey ?

Si votre clé API a été bloquée (Ma clé API est-elle bloquée ?), c'est que vous n'avez pas respecté les limites d'appels des API spécifiées à plusieurs reprises dans la documentation technique des différentes API.

Ce blacklistage est définitif et il n'est pas possible de débloquer celle-ci. C'est pour cela qu'il est important de veiller (avant toute mises en service de vos scripts) à respecter scrupuleusement les limites d'appels, mais également effectuer une mise en cache des informations sur votre propre serveur.

Page 1 of 2 All times are UTC
Powered by phpBB® Forum Software © phpBB Group
http://www.phpbb.com/