Orange API
solutions de communication pour vos applications métiers ou pour vos services web et mobile
english
FAQ
Ici vous trouverez tout ce que vous devez savoir pour commencer à utiliser les API.
previous next Puis-je accéder aux API en HTTPS? Oui, remplacez simplement le HTTP par HTTPS quand vous utiliser la méthode du Web service. A quel moment sait-on que l’API est lancée commercialement? L’équipe d’orange api vous informe de l’évolution des API via le site internet, le blog, les news et l’espace communautaire. Je souhaite utiliser les API d’Orange. Par où dois-je commencer? Pour utiliser les API d’Orange, vous devez tout d’abord devenir membre du site orange api (gratuit).Vous obtiendrez alors votre Access Key dans « mon compte »de votre espace personnel. L'API Access Key est une clé qui permet l’identification de votre compte. Ce code est strictement personnel et confidentiel. Que signifie une API en mode Beta? Cette appellation dépend du degré de maturité de l’API. Une API en mode Beta signifie qu’elle est en utilisation gratuite avec des quotas d’utilisation journaliers et qu’elle est en cours de maturation. Elle est ensuite lancée commercialement lorsqu’elle n’est plus limitée et est payante. Quels langages de programmation peut-on utiliser pour accéder aux API d’Orange? 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, mais ne vous croyez surtout pas limité à ces options! J'ai reçu un code erreur: 999 quand j'utilise l'API. Qu'est-ce que cela signifie? Dans le cadre de nos efforts de vous fournir avec un excellent service lorsque vous recevez ce code d'erreur, cela signifie que nous sommes en train de travailler sur les API. Nous nous excusons et vous invitons à réessayer dans quelques minutes. J'ai reçu le code erreur « 442: unauthorized source for this destination», quand j'ai testé l'API. Pour quelle raison? Le format du numéro de téléphone est incorrect. Il faut ajouter 33 (pour la France) au numéro du mobile et supprimer le 0 cela donne par exemple : 336 12 34 56 78. Comment signaler un bug sur une API? Le meilleur moyen est de nous contacter en cliquant sur « contactez-nous ». Qui contacter en cas de problème d’utilisation avec les API d’Orange? Tout d’abord, les fiches produits de chaque API dans le « developer centre » du site vous permettent de vous familiariser avec les API. Pour en savoir plus, vous pouvez poster vos questions et vos problèmes dans « questions » que vous trouverez dans l’espace « News & community ». Vous pouvez également poster votre réponse dans l’espace « support » en cliquant sur « Contactez-nous ». Les équipes d’orange api vous répondront personnellement. Comment tester les API d’Orange? Utilisez l’outil API Explorer Tool pour tester vos applications.Cet outil met à votre disposition une interface très intuitive qui vous permet de tester toutes nos API et de comprendre leurs différentes fonctionnalités.Retrouvez cette fonction dans « outils ». A quoi sert l'API explorer tool? Avec votre Access key, vous avez la possibilité d’appeler n’importe quelle API et d’obtenir directement les paramètres d’entrées et de sorties de l’API. Et d’autre part, l’API explorer tool met à votre disposition une Sandbox qui vous permet de tester vos applications gratuitement en recevant les codes de sorties qu’ils soient de succès ou d’échec.Qu'est ce que l'API explorer tool? Utilisez et explorez les différentes fonctionnalités de nos API dans une interface intuitive unique sans pour autant assembler une application. Qu'est-ce-que le widget editor? Cet outil basé sur la technologie Flex, possède une interface très intuitive et vous permet de créer vos widgets à l’aide de simples drag and drops. Les widgets sont customisables et peuvent être publiés en un seul clic sur votre propre blog, page Web ou bien sur des sites (comme iGoogle, Netvibes, Facebook, MySpace, Bebo, Blogger, TypePad, widget editor est disponible dans la section "outils" des API. A quoi sert la rubrique? Les outils (widget editor et API Explorer Tool) vous permettent d’utiliser et d’explorer les API. Par exemple, vous avez la possibilité d’appeler n’importe quelle API et d’obtenir directement les paramètres d’entrée et de sortie de celle-ci. Cet outil met aussi à votre disposition une Sandbox vous permettant de tester vos applications sans débourser le moindre crédit. Vous trouverez la section "Outils" dans la rubrique « support » d’orange api. Puis-je rechargé automatiquement mon compte quand je n’ai plus de crédits? Oui, vous pouvez rechargé directement votre compte dés que vous n’avez plus de crédits. Cette nouvelle fonctionnalité disponible dans "mes comptes “ de l’espace personnel sous la rubrique « administrer mes comptes » vous permet d’activer l’option de rechargement automatique, ainsi que configurer à votre guise le mode de rechargement. Selon vos paramaîtrages, votre compte se rechargera automatiquement afin que votre service continue de fonctionner, dès que votre compte de crédit sera descendu sous un nombre de crédits que vous aurez fixé au préalable.
 Vous pouvez désactiver cette option de rechargement automatique à tout moment dans « mes comptes ». Orange utilise le standard PCI-DSS pour protéger ces informations privées. Puis-je être alerté si mon niveau de crédits est bas? Oui, vous pouvez mettre en place une "Alerte“ dans « mes comptes» sur votre espace peronnel, ce qui vous indiquera par email que vous êtes sous le seuil de crédits que vous aviez défini. Puis-je transformer mes « gains » en crédits sans passer par mon compte bancaire? Bien entendu, il suffit d’aller sur «mon espace personnel» dans «mes comptes» et de cliquer sur l’un des 5 packs de crédits que nous proposons. Sur la page suivante, il vous sera demandé si vous désirez acheter ces crédits avec votre carte bancaire ou à l'aide de vos "gains de crédits". Et bien choisissez «gains de crédits ». La transaction est faite. J’ai essayé la fonction «transfert de credits» mais je n’ai rien reçu depuis 15 jours? Il n’y a pas d’erreur, les demandes de transferts vers un compte bancaire sont prises en compte en fin de mois, il faut compter quelques jours pour que le transfert soit réalisé. Puis-je être alerté si mon niveau de crédits est bas? Oui, vous pouvez mettre en place une "Alerte“ dans « mes comptes» sur votre espace peronnel, ce qui vous indiquera par email que vous êtes sous le seuil de crédits que vous aviez défini. Est-il possible de convertir des crédits en argent? Après avoir gagné des crédits grâce aux API rémunératrices (comme la réception de SMS surtaxés), vous pouvez transférer vos crédits de “revenue sharing“ soit vers votre compte prépayé, soit vers votre compte bancaire. Rendez vous sur votre espace personnel dans la rubrique « mes comptes », puis, « administrer vos comptes ». Cliquez sur le lien « Verser les gains de votre livret sur votre compte bancaire ». Les demandes de crédits peuvent se faire à tout moment, et seront traitées le 1er du mois suivant. Le tout premier transfert se fera le 1er juin pour les comptes bancaires hébergés en France. Un minimum de 10€ de crédit devra être atteint pour le reverser sur son compte bancaire. Où acheter des crédits? Allez dans «mon espace personnel» et cliquez sur «mes comptes» . Vous pouvez acheter des pack de crédits. Plus vous achetez des crédits et plus orange api vous offrent des crédits! Où puis-je suivre l’état de mes crédits? Allez dans «mon espace personnel», puis sur «mes comptes ». C’est votre espace personnel, vous pouvez acheter, gagner, et transférer vos crédits facilement. Qu’est ce que le reversement? Vous pouvez également acheter des crédits, être alertés par mail quand vous n’avez plus de crédits, ainsi que transférer vos crédits gagnés sur votre compte bancaire et enfin consulter votre historique de transactions. J’ai déposé un message publicitaire sur ma boîte vocale et je voudrais le diffuser à mes contacts, que dois-je faire? Il faut créer la méthode « receive voicemashupCall », ce qui vous permet de recevoir et donc diffuser un dialogue précis. Sachez qu’il faudra remettre un code PIN à vos contacts pour qu’ils puissent écouter votre message. Ce code est fourni dans votre espace personnel ; « mes API » puis cliquez sur « configurer mes API ». Où puis-je retrouver des exemples pour les API? Allez dans la partie « exemple de code simple » sur la fiche produit pour cet API. Puis-je personnaliser l’attente de mise en relation de mes appels? Effectivement, le paramètre « audioURL » vous permet de jouer le fichier audio de votre choix durant cette attente. A quoi sert le paramètre CallConfirmation? Il sert à demander une confirmation avant de passer l’appel. Vous pouvez également spécifier la langue du callConfirmation en français ou en anglais avec le paramètre «Lang». Je veux lancer un appel, mais limiter celui-ci, que dois-je faire? Le paramètre « maxduration » permet de spécifier une limitation de durée d’appel (en secondes). J’ai reçu un code erreur, de quoi s’agit-il? Retrouvez la liste de tous les codes erreurs sur chaque fiche produit de chaque API. Combien cela coûte-t-il d’utiliser les API d'Orange? Tout dépend de l’API et de son « mode ». En mode « bêta», les API sont gratuites avec des restrictions d’utilisations, alors que les API lancées commercialement 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. Quelles sont les limitations des API d’Orange? Actuellement, les API en mode bêta sont gratuites, mais il existe quelques restrictions d'utilisations, par exemple, une limite de 10 MMS par jour. Les API peuvent-elles être utilisées dans tous les pays? 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 produit de l’API en question et n’hésitez pas à naviguer sur notre blog ou nos pages news. Comment fonctionnent les API? Tout simplement avec une requête http à exécuter. Par exemple pour utiliser la méthode «sendSMS» dans l’API SMS : http://sms.beta.orange-api.net/sms/sendSMS.xml?id=[votre API Access Key]&from [numéro court d’émission]&to=[numéro de téléphone]&content=[votre message à envoyer] Qui peut utiliser les API d’Orange? Tout le monde ! Les API d’Orange ont été développées pour les développeurs et les entreprises. Que puis-je faire avec les API d'Orange? Les API d’Orange sont composées de notre interface de programmation propriétaire qui créé vos portes ». En les utilisant, vous pouvez facilement construire des applications qui peuvent se connecter au réseau Orange ainsi qu’à leurs plateformes. Que sont les API d'Orange? Les API d'Orange (Application Programming Interfaces) sont un ensemble d’API, destinées aux développeurs (experts ou non) qui désirent utiliser les plateformes et services du réseau Orange dans leurs propres applications. On m’a volé mon API Access Key, que dois-je faire? Régénérez automatiquement votre API Access Key dans l’espace personnel en cliquant sur « mon compte » puis sur « Changer mon API Access Key ». Contactez le support du site si vous rencontrez un problème. J’ai perdu mon API Acces Key, que dois-je faire? Régénérez automatiquement votre API Access Key dans votre espace espace personnel, cliquez sur « mon compte » puis sur « Change Access Key ». Contactez le community manager du site si vous rencontrez un problème. Puis-je personnaliser mon API Access Key? Non, les clés sont générées automatiquement. Puis-je diffuser mon API Acces Key sur l’espace « questions »lorsque j’ai un problème d’utilisation? Non, il ne faut jamais diffuser son API Access Key. Qu’est ce que l’ API Access Key? Vous trouverez cette clé sur la première page de « mon compte ». Celle-ci est un paramètre confidentiel et ne doit en aucune manière être diffusée. Elle vous permet l’utilisation de toutes nos API, l’identification lors de chaque appel d’API et le contrôle de vos crédits. A quelle date remonte l’historique de mes appels API? Vous pouvez y retrouver vos 10 actions enregistrées en allant sur votre rapport d'activité dans votre espace personnel. A quoi sert « mon rapport d’activité » dans l'espace personnel? Vous y trouverez l’historique de tous vos appels API. Qu’est ce que « mon espace personnel»? Cet espace vous permet de contrôler et de configurer toutes vos API ainsi que votre compte (API Access Key, compte prépayé, revenue sharing, historique d’utilisation …). A quoi sert l’espace «activer» de la fiche produit? Il permet le paramétrage de chaque API :
Est-il possible d’envoyer un SMS avec le short code 51244? Non, les seuls short codes utilisables pour envoyer des SMS sont les : 20345, 38100, 967482 et 447797805210. Est-ce que ce short code est réservé aux appels britanniques? Non, notre numéro est en effet un numéro britannique, mais c’est le short code pour la zone de couverture internationale. Il peut être utilisé en réception et en émission de SMS. Nous avons choisi ce numéro pour que notre service dispose de la meilleure couverture géographique à l'international (600 opérateurs à ce jour). Cette couverture serait moindre avec un numéro français, italien ou allemand. J’utilise l’API SMS, dois-je créer de nouveaux mots-clés? Non, les mots-clés des API SMS et MMS sont partagés. Un mot clé rajouté pour l’API SMS fonctionnera aussi avec l’API MMS et inversement. Comment doit-on gérer l'envoi d'un message à 1000 numéros ou plus via l'API SMS? Dans un fichier "annuaire.txt", inscrivez-y simplement tous les numéros des destinataires (nombres illimités) avec un saut de ligne entre chaque, comme cela : 33612345678 33612345678 33612345678 Est-il possible de faire un saut de ligne dans mon message plutôt que de faire un espace? Oui tout à fait, un patch autorisant l'insertion d'un saut de ligne à la place d'un espace après les mots clés du SMS est mis en place. Vous pouvez donc insérer un saut de ligne à la place d'un espace après votre mot clé de SMS. Puis-je changer le format d’un SMS? L’ API SMS utilise le codage GSM 7bits qui supporte seulement les caractères romains. Quel est le nombre total de mots clés que puis-je avoir sur l'API SMS? Orange API met à votre disposition 5 mots clés par compte. Où puis-je retrouver des exemples pour l’API SMS? Allez dans la partie « exemple de code simple » sur la fiche produit de l’API SMS. Qu’est-ce que l’API SMS? L’API SMS permet d’envoyer et de recevoir vos SMS partout dans le monde. Puis-je cacher le numéro de l’appelé lors d’un click-to-call? Oui, le paramètre « private » permet de définir la visibilité du numéro : vous pouvez soit cacher le numéro de l’appelé, de l’appelant ou les deux en même temps. Où puis-je retrouver des exemples pour l’API click-to-call? Allez dans la partie « exemple de code simple » sur la fiche produit de l’API click-to-call. Qu’est-ce que l’API click-to-call? l'API click-to-call permet de créer des appels téléphoniques. Comment récupérer les données de la géolocalisation? Une fois l'autorisation accordée, utilisez la méthode « getLocation » pour obtenir la position du mobile. Les données de localisation vous seront transmises au format GPS (c’est à dire qu'elles indiqueront la latitude et la longitude). J’ai fait un createAuthorization sur un numéro étranger, mais ça ne fonctionne pas, pourquoi? Actuellement, le service est disponible pour les mobiles du réseau Orange France (opérateurs partenaires inclus). Une évolution future permettra d’offrir une disponibilité multi opérateur. Nous ne pouvons vous donner de date précise quant à l'extension de la couverture de l'API location, car chaque pays a ses propres contraintes en terme de réglementation de la vie privée et aucun broker ne propose une solution valable dans le monde entier. Nous devons donc traiter indépendamment avec chaque pays. Combien de temps le géolocalisation est valable sur un mobile? Elle est valable jusqu’à ce que le propriétaire du numéro se désabonne de votre service en envoyant un SMS au 20345 avec le message suivant : “non «nom du service»â€. Quelles sont les étapes à suivre pour géolocaliser un téléphone mobile? L'utilisateur final doit envoyer deux SMS pour confirmer son souhait d'être géolocaliser. Le processus se fait en 2 SMS : premièrement vous répondez « oui » avec le « nom du service » vers le 20345 ce qui autorise le mobile pour ce service et deuxièmement, vous répondez « oui location » vers le 20633 ce qui autorise le mobile à la plateforme orangePuis-je géolocaliser un téléphone mobile simplement avec son numéro de téléphone? Oui en partie, par contre, il faut l’autorisation du propriétaire. Où puis-je retrouver des exemples pour l’API location? Allez dans la partie « exemple de code simple » sur la fiche produit de l’API location. Qu’est-ce que l’API location? L’API location permet de géolocaliser des mobiles. Puis-je insérer du son et une vidéo à mon image? Oui, c’est tout à fait possible, le MMS peut contenir une image (en JPG ou GIF), un son (en WAV, MP3 et AMR) et une vidéo (en AVI et 3GP). Où puis-je retrouver des exemples pour l’API MMS? Allez dans la partie « exemple de code simple » sur la fiche produit de l’API MMS. Qu’est-ce que l’API MMS Bêta? L’API MMS permet d’envoyer et de recevoir des fichiers multimédias sur mobiles, gratuitement, mais avec des restrictions. La version commerciale suivra par la suite. Est-ce que l'API email permet d'envoyer des fichiers texte? Non, il n'y a pas de gestion de pièces jointes dans l'API email. Néanmoins, vous pouvez inclure le contenu du fichier texte dans le corps du message. Où puis-je retrouver des exemples pour l’API email? Allez dans la partie « exemple de code simple » sur la fiche produit de l’API email. Qu’est-ce que l’API email Bêta? L’API email permet d’envoyer et de recevoir des emails via votre site web ou votre application. |
Fermer
Vous n'avez pas trouvé votre réponse?
Vous souhaitez des compléments d'information?
Vous souhaitez contacter nos équipes commerciales?
contactez-nous, nous vous répondrons sur votre adresse email.
Chargement en cours...