# -*- coding: utf-8 -*-
from urllib import request
import json
token = 'Your token' #Your first token must be generated on our plateform at https://my.smsfactor.com/developers/api-tokens
content = 'Test API python'
numbers = ['33601020304', '33612345678']
recipients = [];
for number in numbers:
recipients.append({'value': number})
data = {
'sms': {
'message': {
'text': content
},
'recipients': {
'gsm': recipients
}
}
}
data = json.dumps(data).encode('utf-8')
req = request.Request('https://api.smsfactor.com/send', data)
req.add_header('Accept', 'application/json')
req.add_header('Authorization', "Bearer %s" % token)
with request.urlopen(req, data) as f:
print(f.read().decode('utf-8'))
L'API fonctionne avec les bibliothèques standard de Python (urllib et json). Il n'y a pas de SDK pip à installer. Il suffit de copier l'exemple de code disponible dans la documentation et de renseigner votre token API.
Oui. Une seule requête POST avec un tableau de numéros dans "recipients" suffit. Tous les destinataires reçoivent le même message, que vous en ayez dix ou plusieurs milliers.
Oui. L'API repose sur un simple appel HTTP POST, ce qui la rend compatible avec tous les frameworks Python. Il suffit d'intégrer l'appel dans une vue ou un service de votre application.
L'API renvoie une réponse au format JSON avec le statut de l'envoi, le nombre de crédits consommés et un identifiant de message. L'identifiant permet ensuite de suivre la livraison via les webhooks.
