Créer et administrer vos comptes utilisateurs

Consulter le solde de votre compte et Automatiser dans vos développements web la gestion "multi-comptes" via API !

La Gestion Utilisateur et "Multi-compte"

Important : L'encodage supporté est : ISO-8859-15 (Europe de l'Ouest)

1. Consulter le solde en crédit SMS PRO et ECO de votre compte

L'URL d‘appel pour la consultation du solde d’un compte utilisateur : https://sms.capitolemobile.com/api/user/balance

La chaîne de caractère constituant le SMS doit commencer par : XML= puis contenir la structure de données suivante :


<SMS>



<authentification>

<username></username>

<password></password>

</authentification>


</SMS>

Authentification du compte "revendeur"

username : Le nom d'utilisateur du compte
password : Le mot de passe API (disponible via "SMS" > "Mon API" > "Paramètres API")

Réponse : #solde_pro# PRO ; #solde_eco# ECO

2. Créer un "sous-compte" utilisateur - Réservé "Partenaire"

L'URL d‘appel pour la création d’un sous-compte utilisateur : https://sms.capitolemobile.com/api/user/create

La chaîne de caractère constituant le SMS doit commencer par : XML= puis contenir la structure de données suivante :


<SMS>



<authentification>

<username></username>

<password></password>

</authentification>



<user>

<title></title>

<surname></surname>

<name></name>

<email></email>

<username></username>

<password></password>

</user>



</SMS>

Authentification du compte "revendeur"

username : Le nom d'utilisateur du compte "revendeur"
password : Le mot de passe du compte "revendeur"

Information du "sous compte" à créer

title : Civilité
surname : Prénom
name : Nom
email : adresse email du « sous-compte »
username : Le nom d'utilisateur du "sous compte"
password : Le mot de passe du "sous compte"

Réponse dans le cas d'une création réussie : CREATION_OK;USERNAME:#username#

3. Actualiser le solde d’un « sous-compte » utilisateur - Réservé "Partenaire"

L'URL d‘appel pour l’actualisation du solde d’un sous-compte utilisateur : https://sms.capitolemobile.com/api/user/update_credits

La chaîne de caractère constituant le SMS doit commencer par : XML= puis contenir la structure de données suivante :


<SMS>



<authentification>

<username></username>

<password></password>

</authentification>



<user>

<username></username>

<credits_pro></credits_pro>

</user>



</SMS>

Authentification du compte "revendeur"

username : Le nom d'utilisateur du compte "revendeur"
password : Le mot de passe du compte "revendeur"

Information du "sous compte"

username : Le nom d'utilisateur du "sous compte"
credits_pro : Le nouveau solde SMS PRO du « sous compte »

Réponse dans le cas d'une création réussie : #solde_pro#

Les crédits SMS PRO basculent du compte principal vers le sous compte utilisateur (et vice et versa si le nouveau solde est inférieur à l’ancien, les crédits sont réinjectés dans le solde du compte principal).