Envoi par numéro long
- Home
- Envoi par numéro long
Envoyer des SMS via un numéro long
Cette requête est utilisée pour envoyer des SMS en temps réel ou en différé avec un numéro long.
URL
POST http://api.smspartner.fr/v1/vn/send
Paramètres
Chaque demande d’API prend en charge les paramètres suivants :
apiKey | Clé API de votre compte. Vous l’obtenez dans votre compte SMS Partner. |
---|---|
to | Numéros de téléphone du destinataire.
|
from | Votre numéro virtuel au format internationnal ( 336xxxxxxxx ) |
message | Contenu du SMS. 160 caractères maximum par SMS (au delà, il vous sera décompté un SMS supplémentaire par tranche de 153 caractères).
Attention, certains caractères spéciaux et accentués seront remplacés lors de l’envoi :
|
Paramètres optionnels | |
tag | Chaine de caractère de 20 caractères maximum. |
isStopSms | 1 pour ajouter la mention STOP à la fin du SMS ( obligatoire pour des SMS commerciaux ) |
urlResponse | Url de retour des Réponses (ex: http://www.monurldereponse) |
urlDlr | Url de retour des Accusé de réceptions (ex: http://www.monurldedlr) |
sandbox | Pour tester l’envoi de SMS, vous pouvez utiliser le paramètre sandbox :
Aucun SMS ne sera envoyé, et il n’y aura aucun débit sur votre compte. |
_format | Format de la réponse. Vous pouvez choisir entre JSON ou XML . Par défaut, le format de réponse est JSON . |
Requête
Exemple de requête :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
<?php // Prepare data for POST request $fields = array( 'apiKey'=> 'YOUR API KEY', 'to'=> '336xxxxxxxx', 'from' => '336xxxxxxxx', 'message'=> 'This is your message' ); $curl = curl_init(); curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/vn/send'); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_TIMEOUT, 10); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields)); $result = curl_exec($curl); curl_close($curl); // Process your response here echo $result; ?> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
Imports System.IO Imports System.Net Module Module1 Sub Main() Dim base_url As String = "http://api.smspartner.fr/v1/" Dim apiKey As String = "VOTRE_APIKEY" #send sms url = base_url & "vn/send" #note : utiliser une librairie JSON en production, par exemple : #https//www.nuget.org/packages/Newtonsoft.Json/ Dim parameters As String = String.Format( "{{""apiKey"":""{0}"",""to"":""{1}"",""from"":""{2}"",""message"":""{3}""}}", apiKey, "336xxxxxxxx", "336xxxxxxxx", "message de test") Console.Write(parameters) apiRequest("POST", url, parameters) End Sub Function apiRequest(method As String, url As String, parameters As String) As String Dim request As HttpWebRequest request = WebRequest.Create(url) request.Method = method request.Timeout = 10000 # timeout in ms request.ContentType = "application/json; charset=utf-8" request.ContentLength = 0 #set POST data If Not String.IsNullOrEmpty(parameters) Then request.ContentLength = parameters.Length Using reqStream As StreamWriter = New StreamWriter(request.GetRequestStream()) reqStream.Write(parameters) End Using End If #get response Dim returnValue As String = Nothing Using response As HttpWebResponse = request.GetResponse() If response.StatusCode = HttpStatusCode.OK Then Using resStream = response.GetResponseStream() If resStream IsNot Nothing Then Using reader As New StreamReader(resStream) returnValue = reader.ReadToEnd() End Using End If End Using End If End Using apiRequest = returnValue End Function End Module |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
# std import logging import json from collections import OrderedDict # 3p import requests API_KEY = "MY API KEY" URL = "https://api.smspartner.fr/v1" class SMSPartner(): def send_sms(self, to, from, msg): print(to) data = OrderedDict([ ("apiKey", API_KEY), ("to", to), ("from",from), ("message", msg) ]) url = URL + "/vn/send" r = requests.post(url, data=json.dumps(data), verify=False) r_json = r.json() if r_json.get("success") == True: print(r_json) status = True else: print("SMS msg {} not delivered to {}".format(msg, to)) status = False return status |
1 |
curl -H "Content-Type: application/json" -X POST -d '{"apiKey":"xxxxx","to":"xxxx","from":"xxx","message":"test"}' https://api.smspartner.fr/v1/vn/send |
Réponses
1 2 3 4 5 6 7 8 |
{ "success":true, "code":200, "message_id":xxx, "nb_sms": 1, "cost": xxx, "currency": "EUR" } |
1 2 3 4 5 6 7 8 9 10 11 |
<?xml version='1.0' encoding='UTF-8'?> <result> <entry>true</entry> <entry>200</entry> <entry>xxx</entry> <entry>1</entry> <entry>xxx</entry> <entry> <![CDATA[EUR]]> </entry> </result> |
© 2019 SMS Partner. Tous droits réservés. Mentions légales