Interface SMS HTTP/HTTPS
Prêt à tester l’interface SMS HTTPS en quelques minutes en 3 étapes : Copier le code ► S’inscrire ► Activer et configurer l’API ► Tester
Copier le code dans le langage de
programmation approprié
c#
var url = "https://url.ecall.ch/api/sms";
var client = new WebClient();
var method = "POST";
var parameters = new NameValueCollection();
parameters.Add("username", "foo");
parameters.Add("password", "bar");
parameters.Add("message", "Hello eCall World");
parameters.Add("address", "0041XXXXXXXXX");
client.UploadValues(url, method, parameters);
S’inscrire et se connecter
Pour tester l’interface, un compte est nécessaire. Celui-ci est gratuit.
Pour des raisons de sécurité, votre mot de passe vous sera envoyé par SMS.
Activer et configurer
Une fois inscrit, vous pouvez activer l’API vous-même dans la section « Interfaces » de votre compte et effectuer d’autres configurations.
Vous avez besoin de plus de 40 SMS pour tester ? Pas de problème. Contactez un expert eCall
Télécharger la description
Cliquez sur le lien pour télécharger la description au format PDF :
Télécharger la description de l’accès HTTP/HTTPS eCall au format PDF
Brève description de l’interface SMS HTTPS
L’accès HTTPS d’eCall vous permet d’accéder directement à une URL pour envoyer des messages à différents systèmes d’appel.
Conditions préalables à l’utilisation de l’accès HTTPS
Pour pouvoir envoyer des messages via l’interface SMS HTTPS, les conditions suivantes doivent être remplies :
- Vous devez disposer d’un compte d’entreprise (forfait Business) chez eCall ; pour la période d’essai (30 jours), un compte standard (forfait Privé) suffit
- Vous devez activer l’interface HTTP dans votre compte eCall
- Votre logiciel doit pouvoir appeler une URL pour envoyer des messages
Exemple
Formats de messages Accès HTTPS
Les messages peuvent être envoyés à l’aide des méthodes GET ou POST. Les règles suivantes doivent être respectées :
- Tous les paramètres se composent d’un mot-clé (ID) et de la valeur souhaitée correspondante
- Les éléments du message sont séparés les uns des autres par le signe « & » (obligatoire pour GET, également pour POST si le type de contenu est « application/x-www-form-urlencoded »)
- L’ID et la valeur sont séparés par un signe égal « = »
- Les ID sont insensibles à la casse (c’est-à-dire que les majuscules et les minuscules n’ont pas d’importance) Tous les caractères doivent être transmis en codage UTF-8. De plus, les caractères doivent être codés en URL si nécessaire (par exemple « » pour un espace, ou «+» pour un signe «+»)
Remarque :
Pour des raisons de performance, l’interface HTTPS met en cache les paramètres du compte. Par conséquent, les modifications apportées aux paramètres peuvent, dans certains cas, ne prendre effet dans l’interface HTTP qu’après un certain délai.
