Ajouter un contact

URL

POST http://api.smspartner.fr/v1/contact/add

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.
phoneNumber	Numéro de téléphone du contact. 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.
Paramètres optionnels
firstname	Prénom (32 caractères maximum)
lastname	Nom (32 caractères maximum)
date	Date au format YYYY-MM-DD. Pourra être utilisé pour des envois automatique (ex: anniversaire )
url	Url , elle doit commencer par http:// ou https://
custom1	Champ personnalisé 1
custom2	Champ personnalisé 2
custom3	Champ personnalisé 3
custom4	Champ personnalisé 4

Requête

Exemple de requête :

{
  "apiKey": "YOUR_API_KEY",
  "groupId": "ID GROUP",
  "contact": {
    "phoneNumber": "xxxxxxxxx",
    "firstname": "prénom",
    "lastname": "nom",
    "date": "YYYY-MM-DD",
    "shortUrlPartnr": "http://",
    "url": "http://",
    "custom1": "custom 1",
    "custom2": "custom 2",
    "custom3": "custom 3",
    "custom4": "custom 4"
  }
}

{

"apiKey": "YOUR_API_KEY",

"groupId": "ID GROUP",

"contact": {

"phoneNumber": "xxxxxxxxx",

"firstname": "prénom",

"lastname": "nom",

"date": "YYYY-MM-DD",

"shortUrlPartnr": "http://",

"url": "http://",

"custom1": "custom 1",

"custom2": "custom 2",

"custom3": "custom 3",

"custom4": "custom 4"

}

Réponses

{
  "success": true,
  "code": 200,
  "contact": {
    "phoneNumber": "xxxxxxxx",
    "firstname": "Prénom",
    "lastname": "Nom",
    "date": "YYYY-MM-DD",
    "shortUrlPartnr": "http://",
    "url": "http://",
    "custom1": "custom 1",
    "custom2": "custom 2",
    "custom3": "custom 3",
    "custom4": "custom 4",
    "contactId": "ID CONTACT"
  }
}

{

"success": true,

"code": 200,

"contact": {

"phoneNumber": "xxxxxxxx",

"firstname": "Prénom",

"lastname": "Nom",

"date": "YYYY-MM-DD",

"shortUrlPartnr": "http://",

"url": "http://",

"custom1": "custom 1",

"custom2": "custom 2",

"custom3": "custom 3",

"custom4": "custom 4",

"contactId": "ID CONTACT"

}

Erreurs

Exemple de message d’erreur :

{
  "success": false,
  "code": 10,
  "message": "Clef API incorrecte"
}

{

"success": false,

"code": 10,

"message": "Clef API incorrecte"

}

Code de contrôle

	Code erreurs
1	groupId est requis
2	Contact infos sont requises
10	La Clé API est requise
15	Le numéro est déjà dans le groupe

Obtenir la liste des contacts d’un groupe