Etape 1 - Créez votre compte développeur

 

Pour commencer à utiliser les APIs d'Orange, la première étape consiste à créer un compte:

 

1. Cliquez sur ce lien pour vous inscrire;
    
2. Remplissez le formulaire en utilisant une adresse e-mail valide. Un lien vous sera envoyé à cette adresse afin de créer votre mot de passe et ainsi activer votre compte.

 

 

 

 

Etape 2 - Créez une application

 

Vous pouvez créer des applications dans nos deux environnements: Test (Sandbox) et Production.

 

1. Connectez-vous à votre compte développeur;
    
2. Cliquez ensuite sur votre profil   Mes applications;
    
3. Créez une application sur l'environnement Sandbox ou Production. Par défaut, l'environnement de test (Sandbox) est disponible et vous pourrez y effectuer vos premiers tests. Pour les applications en production, des documents complémentaires sont nécessaires à l'autorisation de l'accès à l'environnement.
   Vos accès seront disponibles dans les détails de l'application que vous venez de créer;
    
4. Enfin, un mail vous sera envoyé pour confirmer la création, et vos accès seront disponibles sur les détails de l'application (Sandbox ou Production).

 

N.B: Les applications en production passent nécessairement par une phase de validation.

 

 

 

Etape 3 - Générez un token

 

Tout accès à nos APIs nécessite une authentification par le biais d'un token. Ce dernier est unique par application et doit donc être stocké de manière sécurisée. Il a également une durée de validité de cinq (5) minutes.

 

Comment obtenir un token?

 

 

Pour générer un token, il vous faudra utiliser vos accès:
 

• client_id: votre identifiant client
   
• client_secret: votre clé secrète

Ce seront les paramètres que vous utiliserez pour exécuter la commande ci-après, suivant l'environnement dans lequel vous vous trouvez:

 

 

Environnement de test (Sandbox)

 

my_token=$(curl -k -d client_id={your_client_id} -d client_secret={your_secret} -d grant_type=client_credentials https://api.sandbox.orange-sonatel.com/oauth/token)

 

Environnement de production

 

my_token=$(curl -k -d client_id={your_client_id} -d client_secret={your_secret} -d grant_type=client_credentials https://api.orange-sonatel.com/oauth/token)

 

 

 

Etape 4 - Faites votre premier test

 

Après obtention d’un token, vous pouvez à présent accéder à l'espace de test. Voici un exemple de requête que vous pourrez y effectuer:

 

Consultation de solde d'un compte

 

curl -k -H 'Accept: application/json' -H "Authorization: Bearer ${my_token}" https://api.sandbox.orange-sonatel.com/api/eWallet/v1/account?msisdn=${your_msisdn}