|
||||||||||||||||||||||||||
|
FAQ générale sur les API
L’abréviation API signifie Application Programming Interface (Interface de programmation d’application en français). Les API d’Orange offrent un accès aux services du réseau Orange, à des services personnels et de communication, ainsi qu’à des solutions multimédia.
Visitez la rubrique « API » sur le site d’Orange Partner pour en savoir plus sur les différentes catégories d’API disponibles (Advanced, Instant et Personal) et leur contenu.
Tout dépend de la catégorie d’API que vous souhaitez utiliser. Les étapes de développement à suivre sont décrites sur la page principale de chaque catégorie d’API (Advanced, Instant ou Personal).
Mais si vous voulez commencer à développer et accéder à l’API Manager, vous devrez vous inscrire en tant que membre d’Orange Partner. Bonne nouvelle : ceci ne vous coûtera rien !
Tout dépend de la catégorie de l’API et de son « mode ».
En mode « alpha », les API sont gratuites avec des restrictions d’utilisation, alors que les API en mode « bêta » nécessitent l’achat de crédits.
Les tarifs varient aussi d’une catégorie à l’autre, donc consultez la rubrique « tarifs » de l’API en question pour plus d’informations.
Certaines API offrent une couverture internationale tandis que d’autres ne sont disponibles que dans certains pays. Nous améliorons continuellement notre couverture donc vérifiez régulièrement les mises à jour.
Pour plus d’informations sur la couverture, consultez la page de l’API en question.
Et n’oubliez pas de vous inscrire pour recevoir nos alertes API et être ainsi informé des dernières actualités les concernant.
Nous lançons toujours nos API en mode alpha. Ce n’est que quand une API a fait ses preuves que nous la faisons passer en mode bêta pour finalement la commercialiser en version complète.
Comme les API sont mises en œuvre par le biais de services Web, les API d’Orange ne dépendent d’aucun langage de programmation et sont donc accessibles à partir de plusieurs langages.
Nous proposons de la documentation et des exemples d’applications dans certains langages, tels que PHP, Java et .NET, mais ne vous croyez surtout pas limité à ces options !
Le site d’Orange Partner propose un forum destiné aux développeurs sur lequel vous pouvez poster vos questions ou problèmes. Pour cela, visitez la rubrique « aide et support » de la zone « API ».
Ou vous pouvez également nous envoyer un e-mail à l’adresse developers@orange.com ; il y aura toujours quelqu’un pour vous aider.
Le meilleur moyen est d’envoyer un e-mail à developers@orange.com.
Nous proposons des SDK uniquement pour les Advanced API ; aucun SDK n’est actuellement disponible pour les Instant et Personal API.
FAQ sur les Advanced API
Les Advanced APIs sont un ensemble d'API destinées aux entreprises basées en France, souhaitant utiliser les plateformes et services d'Orange dans leurs propres applications.
Pour utiliser les API Advanced dans votre propre application, vous avez besoin :
Ces informations, ainsi que leur utilisation dans le code, sont détaillées dans la documentation de chaque API (téléchargeable dans l'onglet "développement").
Vérifiez auprès de votre administrateur réseau que l’adresse et le port du point
d’accès ne sont pas bloqués.
L’erreur obtenue est par exemple : en .NET : La connexion sous-jacente a été fermée : Impossible d'établir
une relation de confiance pour le canal sécurisé SSL/TLS
Le certificat actuellement utilisé par le frontal de protection de certaines APIs peut poser problème. Pour le contourner, l faut forcer votre application à faire confiance à ce certificat. Chaque langage de développement gère de façon différente les connexions chiffrées par un certificat serveur. .NET, par exemple, se base par défaut sur les certificats installés dans Windows (dans Options Internet > Contenu > Certificats). Java utilise des ‘keystores’, qu’on peut modifier en utilisant l’outil keytool.
Ainsi, en Java, pour faire fonctionner le service, il suffit de suivre les indications du document ‘Prérequis’ sur la gestion du certificat.
Il y a un problème d’authentification. La plateforme utilise la méthode « Basic Authentication ». Assurez-vous que votre programme est paramétré pour cette méthode, et que vous utilisez les bons identifiant/mot de passe d'accès au réseau d'Orange.
Le paramètre “Partner_API_Account_ID” défini dans l’en-tête SOAP (‘SOAP Header’) de la requête n’est pas défini ou est erroné. Assurez-vous d’utiliser le bon identifiant pour ce service, et d’implémenter correctement l’en-tête SOAP dans la requête.
Les fichiers audio .wav doivent être mono, 8bits, 8kHz, CCIT A-law, de taille inférieure à 2Mo
Le champ email de la méthode joinConference n'est pas pris en compte actuellement, c'est un paramètre fictif qui sera utilisé dans une prochaine version de MMC. Vous devez transmettre manuellement les informations de connexion à votre invité.
Le service DCE ne retourne que les 10 premiers résultats correspondant à votre recherche. Essayez d'affiner votre recherche en précisant le modèle.
Les caractères spéciaux dans le nom des pièces jointes seront remplacés par le caractère ‘_’. De plus, si vous envoyez à la fois un fichier classique et un fichier audio ; ils ne doivent pas porter le même nom. La taille des pièces jointes doit être inférieure à 2 Mo.
La chaîne XML des destinataires est incorrecte.
Si le destinataire est un abonné SFR, le numéro affiché sera le 10108.
C’est l’alphabet GSM simple qui est utilisé:
Tout autre caractère sera remplacé soit par ‘?’, soit par la conversion suivante:
FAQ sur les Instant API
Les Instant API sont un ensemble d’API destinées aux développeurs souhaitant utiliser les plateformes et services du réseau Orange dans leurs propres applications.
Un widget est “objet” virtuel sur lequel l’utilisateur peut interagir. C’est un « raccourci » dynamique permettant de répondre à un besoin d’information régulier comme par exemple le taux de change monétaire qui peut être mis à jour pour différentes monnaies ou la température d’un lieu qui peut être mise à jour pour différents endroits.
Tout le monde ! Les Instant API ont été développées pour les passionnés, les développeurs et les entreprises.
Pour utiliser les Instant API, vous devez tout d’abord devenir membre du programme Orange Partner, Ceci est totalement gratuit..Vous obtiendrez alors votre Access Key depuis l’API manager.
L'API Access Key est une chaîne qui identifie votre compte: la clé est personnelle et, idéalement, doit être gardé secrete
Si l’API est en mode ‘alpha’, vous n’avez pas besoin de crédits car ces API sont totalement gratuites. En revanche, si l’API est en mode ‘beta’, vous pouvez acheter des crédits dans l’API Manager avec votre carte bleue.
Nous sortons nos API en mode ‘alpha’ dans un premier temps, puis, quand une API est assez mature, elle passe du mode ‘alpha’ au mode ‘beta’ avant de finir en model ’commercialisable’.
Actuellement, les API en mode 'alpha' sont gratuites mais qu'il existe quelques restrictions d'utilisation, par exemple, une limite de 10 SMS par jour.
Les API en mode ‘beta’ ont certaines limites de couverture, où seuls certains pays sont couverts.
Cette appellation dépend du degré de maturité de l’API. Dans un premier temps, l’API est utilisable en mode ‘alpha’ : l’API est gratuite avec des quotas d’utilisation journaliers, puis, elle évolue et passe en mode ‘beta’ : des crédits sont nécessaires pour utiliser l’API, mais celle-ci n’est plus limitée en terme d’utilisation.
Oui, remplacez simplement le HTTP par HTTPS quand vous utiliser la méthode du Web service.
Celui-ci vous vous permet de contrôler et de configurer toutes vos APIs ainsi que votre compte (Access Key, compte prépayé, revenue sharing, historique d’utilisation …).
Vous trouverez cette clé sur la première page de l’API Manager. Il s’agit d’un un paramètre à utiliser pour utiliser nos API. Cette clé elle nous permet de vous identifier et de connaitre votre utilisation des API. .
Non, les clés sont générées automatiquement.
Oui, depuis l’API Manager (important si vous pensez que quelqu’un vous l’a volée).
Oui, vous pouvez mettre en place une "Alerte“ qui vous indiquera par email que vous êtes sous le seuil de crédits que vous aviez défini. FAQ sur les Personal API
Les Personal API vous permettent d’accéder aux services utilisés par les clients d’Orange France (www.orange.fr), tels que les favoris, le contenu, etc.
Vous devez accepter nos termes et conditions pour souscrire à nos API ; veuillez donc les lire attentivement.
Nous mettons tout en œuvre pour étendre la couverture de nos API aux téléphones mobiles.
N’oubliez pas de vous inscrire pour recevoir nos alertes API et être ainsi informé des dernières actualités les concernant.
Nous avons créé un site de partage de vos informations, sur lequel vous pouvez voir l’historique des demandes, les règles de partage, la liste des partenaires, etc. Rendez-vous sur la page http://privacy.orange.fr pour plus d’informations.
Le service d’identification Orange, disponible sur les sites Web de certains partenaires, autorise deux protocoles d’authentification :
Pour plus d’informations, rendez-vous sur la page http://openid.orange.fr.
Actuellement, le protocole Orange Authentication est le seul à permettre l’accès aux Personal API.
|
|||||||||||||||||||||||||
