accueilforumsdevenir membreEnglish
site search
le programme applis et solutions mobiles autres innovations API actu et événements

 


L'API Device Capability Enabler fournit à votre application des informations sur les capacités des terminaux mobiles, par exemple taille de l'écran, user agent, support du MMS, prise en charge des codecs pour les téléchargements musicaux et vidéo.

Device Capability Enabler API

 

  •   le service  
  •   caractéristiques techniques  
  •   tarifs  
  •   développement  

L'API Device Capability Enabler (DCE) fournit à vos applications des informations sur les terminaux mobiles comme la taille de l'écran, le user-agent, ou les format audio et vidéo supportés.


L'information logicielle ou matérielle fournie sur l'appareil (ls capabilities) vous permet d'adapter votre service à chaque utilisateur.


DCE permet de faire des requêtes sur les capacités des mobiles en utilisant l'un des trois critères identifiant les terminaux :
 recherche par marque/modèle
 recherche par code TAC
 recherche par user-agent


Ces informations vous permettront de proposer les services les mieux adaptés à vos clients dans le contexte d'expansion du parc d'appareils utilisés par les clients d'Orange ; d'autant plus que tous ces terminaux ont des caractéristiques différentes.

 

les plus !
DCE vous permet de profiter de la connaissance qu'a Orange sur le parc de terminaux mobiles de ses clients, et de vous concentrer sur vos propres services.


La base de données terminaux est mise à jour par Orange en temps réel (avec les corrections et les nouveaux terminaux).

Voici une partie des caractéristiques techniques, pour vous donner une idée de ce qui est possible et comment.


protocoles supportés

 HTTPS
 web services, SOAP protocol


fonctionalitiés

DCE propose trois fonctions de recherche qui retournent la liste des terminaux répondant aux critères de recherche avec la liste des caractéristiques connues pour chacun d'eux :

 recherche par marque / modèle getDeviceCapabilitiesByName
 recherche par TAC code (préfixe IMEI) getDeviceCapabilitiesByTacCode
 recherche par user-agent getDeviceCapabilitiesByUserAgent


caractéristiques

 recherche par marque / modèle
   - renseigner dans la requête la marque et/ou le modèle
     (marque et modèle ne peuvent être simultanément vides)
   - renvoie la liste des caractéristiques des terminaux qui correspondent à la recherche
   - nombre maximum de réponses : les caractéristiques de 10 terminaux


 recherche par code TAC
   - renseigner le code TAC
   - renvoie la liste des caractéristiques des terminaux qui correspondent au code TAC
   - nombre maximum de réponses : les caractéristiques de 10 terminaux


 recherche par user-agent
   - renseigner une chaine user agent
   - renvoie la liste des caractéristiques des terminaux qui correspondent au user agent
   - nombre maximum de réponses : les caractéristiques de 10 terminaux


limitations

Nombre maximum de réponses : les caractéristiques de 10 terminaux.

Certaines caractéristiques peuvent être différentes de celle connue dans la base (notamment si un utilisateur 'avancé' a mis à jour ses programmes).


architecture



erreurs

 fonctionnelles
   - NoDeviceFound (code 1) Aucun terminal ne correspond pas à la recherche
   - UnknownUser (code 2) Utilisateur inconu ou mauvais mot de passe


 technique
   - databaseException (code -1) Erreur base de données
   - UnknownException (code -99) Erreur non identifiée

L'utilisation de l'API est gratuite.

matériel de développement

Kits de développement (bibliothèques et documentations incluant des exemples de codes, sous licence Apache 2) :

Java 1.5

zip icon kit de développement Javaarrow (v 1.1.3)

incluant bibliothèques, documentation et fichiers source

pdf icon manuel SDK Javaarrow (v 1.1.3)

.NET 3.5

zip icon kit de développement C#arrow (v 1.1.3)

incluant bibliothèques, documentation et fichiers source

pdf icon manuel SDK C#arrow (v 1.1.3)

Retrouvez également le SDK des API Orange sur CodePlex. Ce SDK global pour .Net contient des exemples de code, en particulier pour cette API.

PHP version 5

zip icon kit de développement PHParrow (v 1.1.3)

incluant bibliothèques, documentation et fichiers source

pdf icon manuel SDK PHParrow (v 1.1.3)

 

Intégration directe de l'API SOAP :

WSDL integration

zip icon WSDL et document d'intégrationarrow (v 1.1.3)

incluant documentation, manuel de référence et exemples d'appel

pdf icon manuel du développeurarrow (v 1.1.3)

 

Certificat serveur :

certificat serveur

zip icon certificat serveur SSLarrow

nécessaire pour l'authentification par SSL.

 

Utiliser l'API, c'est simple. Il vous suffit de suivre les étapes suivantes :

 

tester et commander l'API

 

 Pré-requis : devenir membre Premium

 Le test d'une API nécessite l'inscription sur le site Orange Partner (membre), et l'accès

   au statut Premium.

 

 Si vous n'êtes pas déjà membre d'Orange Partner, inscrivez-vous maintenant, et

   n'oubliez pas de cocher la case « Oui je souhaite utiliser les APIs Orange » sur

   le formulaire d'inscription.

 

 Si vous êtes déjà membre d'Orange Partner, connectez-vous et vérifiez votre compte :

   cochez la case « Oui je souhaite utiliser les APIs Orange ».


 Pour devenir membre Premium, veuillez remplir le formulaire d'enregistrement

   (N'oubliez pas de cocher la case « Please tick the box if you're a business based

   in France wishing to access trial and live APIs » et de renseigner le numéro SIRET

  de votre entreprise).

 

  Si vous êtes déjà membre Premium, connectez-vous et vérifiez votre compte : cochez

   la case « Please tick the box if you're a business based in France wishing to

   access trial and live APIs » et renseignez le numéro SIRET de votre entreprise.


 Dans les 2 cas, vous recevrez un accusé de réception par email, puis sous quelques

   jours, une confirmation de votre statut Premium.


Une fois devenu membre Premium, cliquez sur le bouton "tester" ci-dessus, pour obtenir les identifiants utiles à l'intégration de l'API de test.

 

Selon votre mode d'intégration et votre langage de développement, téléchargez ci-dessus :

Le kit de développement pour java, .Net ou PHP, et la documentation associée

Le WSDL et son guide d'intégration directe

Suivez les instructions de cette documentation pour intégrer l'API.

 

commander l'API

Vous avez testé l'API, et vous en êtes satisfait ?

 

Pré-requis : devenir partenaire sous contrat

 Votre responsable partenaire Orange Business Services vous présentera les avantages

   et modalités du partenariat Orange et du contrat associé.

 

Une fois devenu partenaire sous contrat, cliquez sur le bouton "commander" ci-dessus, pour obtenir les identifiants utiles à l'intégration de l'API.

 

Gérez ensuite vos API, à partir du menu de gauche *** API manager ***.

 

(back to top)

à noter...

 Cette API est uniquement 
   destinée aux entreprises
   basées ou ayant une filiale
   en France
 Veuillez lire le
   guide utilisateur

si quelquechose n'est pas clair

essayez ceci...


 lisez le guide utilisateur

Veuillez lire le guide utilisateur qui vous guidera à travers les différentes étapes de développement avec cette API.

téléchargez le guide utilisateur


 lisez les FAQs

Consultez les FAQs.

FAQs

 

 rejoignez le forum

Un forum est à votre disposition pour poser vos questions relatives aux APIs.

Créez un nouveau thème ou discutez avec d'autres membres qui utilisent les API.

accédez au forum


toujours coincé ?


 envoyez-nous un email

Contactez-nous sur developers@orange.com

téléchargez le SDK unifié

Le SDK unifié est l’agrégation des SDK développés pour les Advanced et les Instant  API.

Vous pouvez donc utiliser le SDK unifié pour développer avec les API des deux familles.

téléchargez maintenantlink arrow

API similaires

 Contact Everyone API
 Multimedia Conference API