important : Travaux d'optimisation des performances des API

techcnique.jpg

Pour vous fournir un meilleur service, nous procédons à des travaux d’optimisation des performances de nos API.

Sachez que les Personal APIs ne sont pas impactées par ces évolutions.

Ces améliorations concernent les requêtes en POST, les codes erreurs, les URLs avec les noms de domaine des API et les certificats de sécurité.

Certaines améliorations pourraient avoir des impacts sur le fonctionnement de vos applications.

Ce message est là pour vous aider à prendre toute les dispositions utiles pour la continuité opérationnelle de vos services.

Pour vous guider dans ces évolutions, nous vous avons mis en place un tableau récapitulatif détaillé de ces travaux d’améliorations avec :

  1. le sujet concerné : Requêtes, codes erreur, URLs.
  2. la situation actuelle de ces sujets
  3. le changement effectué pour ces sujets
  4. la mise en production : quand le changement est opéré
  5. la fin du support c'est-à-dire le fonctionnement des anciens paramètres
  6. ce que vous y gagnez : Gain Client

Pour vous aider à mener à bien ces transformations, nous mettons en place un support jusqu’au 31 Mars 2011. A compter de cette date, les anciens paramètres ne fonctionneront plus.

Nous nous excusons par avance des répercussions que ces évolutions pourront avoir sur votre service.

L'équipe de support est  à votre disposition pour d'éventuelles questions sur le
forum feedback.

L'équipe des API d'Orange

Sujet

Situation actuelle

Changement

Mise en production

Fin du support

Gain Client

Requêtes POST lors de l’utilisation des API

Les requêtes sont soit en GET soit en POST.

Ajout du paramètre id=[access key] dans l'URL des requêtes en POST
Aucun changement pour les requêtes en GET

en ligne

31/03/2011

Meilleure corrélation entre méthode GET et POST

Codes erreur

Lorsque l’access key n'est pas renseigné, non valide ou non autorisée ; vous recevez dans le corps du message HTTP 200, un document XML avec le code erreur et le message correspondant

Retour XML des erreurs 400, 401 et 406 encapsulées dans un HTTP 403.
Dans ce cas là, plus de champ <call_id> mais un <timestamp>

15/02/2011

31/03/2011

Gestion des erreurs au niveau du framework HTTP et Applicatif

URLs

Nous avons de nombreuses URLs (sms/call/... .beta/alpha. orange-api.net)

Nous avons désormais un domaine unique pour nos API : run.orangeapi.com
 

en ligne

N/A, les anciennes URLs restent supportées

Une seule URL à retenir

Certificat généré par nous-mêmes ne comportant que certaines des URLs

Certificat signé par Verisign sur le domaine run.orangeapi.com

en ligne

31/03/2011

Facilité d'implémentation

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Soraya Benali

Consultante social media - CM pour @Orange, j'ai animé le blog relation client durant 2 ans. Avant de rejoindre les blogs d'Orange Business, j'étais community manager Orange API.

Dans la vie ? Génération web... Je mange un #donut; j'aime les donuts, c'est ici que j'ai mangé des donuts... Cela vous dit quelque chose ? Un peu vieux jeu, mais ça fonctionne toujours ! Cherchez "les médias sociaux expliqué avec un donut" ;)