|
|
A propos de nos APIs
Qu'est ce qu'une API?
Une API est une interface de programmation (Application Programming Interface ou API), un ensemble de fonctions, procédures ou classes mises à disposition des programmes informatiques par une bibliothèque logicielle, un système d'exploitation ou un service.
Dans le cas présent, nos APIs vous permettent d'utiliser nos services très simplement.
Comment utiliser nos APIs
Connectez vous sur business.geolocalisation-gsm.eu et créez votre compte entreprise gratuitement.
Vous pourrez ensuite suivre l'utilisation de nos APIs en temps réel.
Quels numéros puis je localiser au travers des APIs?
Tous les numeros Orange et SFR
Faut-il souscrire un abonnement pour utiliser vos APIs?
Aucun abonnement n'est requis pour les entreprises.
Chaque demande d'autorisation coute 3 crédits.
Chaque localisation effectuée coute 10 crédits.
Puis je localiser tous les portables?
Oui, sous la conditions que le portable cible a suivi la procédure pour accepter d'être localisé (2 SMS non surtaxé au maximum à envoyer).
Qu'offrez vous dans le détail?
Notre espace vous permet de manière unifiée de localiser n'importe quel téléphone portable et de recevoir un message xml en retour.
Vous pourrez ensuite traiter ce message xml sur votre site afin d'offrir à vos client les services que vous souhaitez.
Nos APIs dans le détail
Attention: dans tous les cas ces APIs ne peuvent être utilisées que depuis l'IP de votre serveur déclarée dans votre compte
Liste des codes retours XML (quel que soit le réseau du téléphone portable à localiser)
|
Code retour
|
Message texte
|
Signification
|
|
200
|
Autorisation_ORANGE_SENT
|
Autorisation envoyé au mobile ORANGE cible avec succès
|
|
200
|
Autorisation_SFR_SENT
|
Autorisation envoyé au mobile SFR cible avec succès
|
|
200
|
ok
|
Localisation effectuée avec succès
|
|
400
|
Parametre_manquant
|
Votre appel à notre API est mal formé.
Un paramètre obligatoire est manquant.
|
|
402
|
Credit_insuffisant
|
Votre crédit restant est insuffisant pour appeler la méthode.
Vous devez recharger votre compte.
|
|
401
|
key_incorrecte
|
Votre clef personnel d'api est incorrecte.
Vérifier la clef en vous connectant sur votre compte.
|
|
403
|
IP_non_reconnue_Modifiez_profil
|
L'IP du serveur ayant appelé notre API n'est pas reconnue.
Modifiez l'IP de votre serveur en vous connectant sur votre compte.
|
|
455
|
User agreement ended
|
L'utilisateur final a mis fin à son consentement de localisation.
(service uniquement implémenté chez SFR).
|
|
451
|
pending authorization
|
L'utilisateur final n'a pas donné son consentement de localisation suite au SMS d'autorisation recu.
|
|
452
|
unauthorized phone number
|
Le mobile n'est pas autorisé. Recommencez la procédure d'autorisation.
|
|
508
|
Message custom
|
L'erreur n'est pas reconnue. Veuillez nous adresser le message.
|
|
500
|
Service Unavailable
|
Le service de localisation est indisponible (coté opérateur). Veuillez réessayer plus tard.
|
|
|
|
|
|