Radionomy Board
It is currently Tue Dec 10, 2019 6:42 am

All times are UTC




Post new topic This topic is locked, you cannot edit posts or make further replies.  [ 12 posts ]  Go to page 1, 2  Next
Author Message
PostPosted: Mon Jun 24, 2013 12:52 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 8:59 am
Posts: 410
Location: Sur le forum
Radio 1: http://www.radionomy.com/feevermix
O.S: Windows Seven 64 Bits
FAQ - API (Liste des questions concernant les API)

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



Top
 Profile Send private message  
 
 Post subject: 1-Qu'est-ce qu'une API ?
PostPosted: Tue Jun 25, 2013 1:11 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 8:59 am
Posts: 410
Location: Sur le forum
Radio 1: http://www.radionomy.com/feevermix
O.S: Windows Seven 64 Bits
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.


Top
 Profile Send private message  
 
PostPosted: Tue Jun 25, 2013 1:16 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 8:59 am
Posts: 410
Location: Sur le forum
Radio 1: http://www.radionomy.com/feevermix
O.S: Windows Seven 64 Bits
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)


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 8:18 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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.


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 8:27 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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,


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 8:32 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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 17826 times ]


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 8:47 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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 17826 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.


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 9:04 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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...


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 9:07 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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.


Top
 Profile Send private message  
 
PostPosted: Fri Jul 26, 2013 9:12 pm 
Offline
Moderators
User avatar

Joined: Mon Jun 24, 2013 4:40 pm
Posts: 1655
Radio 1: http://www.radionomy.com/fr/radio/r-one-radio
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.


Top
 Profile Send private message  
 
Display posts from previous:  Sort by  
Post new topic This topic is locked, you cannot edit posts or make further replies.  [ 12 posts ]  Go to page 1, 2  Next

All times are UTC


Who is online

Users browsing this forum: No registered users and 1 guest


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB® Forum Software © phpBB Group