Envoyer un sondage

Cette requête est utilisée pour envoyer un sondage en temps réel ou en différé.

URL

POST https://api.smspartner.fr/v1/sondage/to/send

Paramètres

Chaque demande d’API prend en charge les paramètres suivants :

  • La plateforme n’envoie pas de SMS commerciaux entre 20h et 8h en semaine et les dimanches et jours fériés (restriction légale). Si un message SMS est envoyé, le message est en pause jusqu’au prochain jour ouvrable à 8h.
  • Vous n’envoyez pas de SMS commerciaux? contactez-nous pour désactiver cette restriction : help@smspartner.fr
apiKey Clé API de votre compte. Vous l’obtenez dans votre compte SMS Partner.
phoneNumbers Numéros de téléphone des destinataires.
Pour l’envoi de plusieurs SMS les numéros doivent être séparés par des virgules.
Ils peuvent être :

  • au format national (06xxxxxxxx) ou international (+336xxxxxxxx), pour des numéros français.
  • au format international (+496xxxxxxxx), pour des numéros hors France.
sondageIdent
Identifiant du sondage
Paramètres optionnels
tag Chaine de caractères de 20 caractères maximum sans espace(s) et en minuscule(s)
scheduledDeliveryDate Date d’envoi du SMS, au format dd/mm/YYYY. A définir uniquement si vous souhaitez que les SMS soient envoyés en différé.
time Heure d’envoi du SMS (format 0-24), obligatoire si scheduledDeliveryDate est défini.
minute Minute d’envoi du SMS (format 0-55, par intervalle de cinq minutes).
, obligatoire si scheduledDeliveryDate est défini.
_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 :

Réponses

Erreurs

Exemple de message d’erreur:

Code de contrôle

Code erreurs
1 La Clé API est requise
2 Le numéro de téléphone est requis
9 Au moins une contrainte n’a pas été respectée lors de l’envoi :

  • L’émetteur ne peut pas être plus long que 11 caractères.
  • Numéro de téléphone non valide.
  • Si scheduledDeliveryDate est défini:
    • La date (dd/mm/yyyy) est antérieure à la date actuelle.
    • La minute est requise.
    • L’heure est requise.
10 Clé API incorrecte
11 Manque de crédits