ajax-loader
rocket

API

Contact

Destination

Expéditeur

Modèle SMS

SMS

Réponse SMS

Utilisateur

Ajouter un contact dans une liste de contacts

Ce service permet d'ajouter un contact dans une liste de contacts Avosms.

POST   https://api.avosms.com/v1/contact/add


Paramètres

Tous les paramètres ci-dessous sont à envoyer en POST.

Liste des paramètres obligatoire
id Votre identifiant de compte AvoSMS (adresse e-mail)
key Clé API disponible depuis votre compte client « Accès API »
listContactId ID de la liste de contacts
contactTelephoneNumber Numéro de téléphone du contact


Liste des paramètres optionnels
contactCivility Civilité du contact.
contactName Nom du contact.
contactFirstName Prénom du contact.
contactEmail Email du contact.
contactBirthday Anniversaire du contact.
contactOther Autre information sur le contact.

Exemple


<?php
$curl = curl_init("https://api.avosms.com/v1/contact/add"); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_COOKIESESSION, true);
$postfields = array( 'id' => "{ID}", //REQUIRED 'key' => "{KEY}", //REQUIRED 'listContactId' => "{LIST CONTACT ID}", //REQUIRED 'contactTelephoneNumber' => "{CONTACT TELEPHONE NUMBER}", //REQUIRED
'contactCivility' => "{CONTACT CIVILITY}", //OPTIONNAL 'contactName' => "{CONTACT NAME}", //OPTIONNAL 'contactFirstName' => "{CONTACT FIRST NAME}", //OPTIONNAL 'contactEmail' => "{CONTACT EMAIL}", //OPTIONNAL 'contactBirthday' => "{CONTACT BIRTHDAY}", //OPTIONNAL 'contactOther' => "{CONTACT OTHER}", //OPTIONNAL );
$postfields_json = json_encode($postfields); $trame = http_build_query($postfields, '', '&'); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_POSTFIELDS, $trame); $raw_response = curl_exec($curl); curl_close($curl);
$response = json_decode($raw_response);
$status_response = $response->status; $code = $response->code;
?>


Codes / Réponses

Lors d'une requête vers nos services, une réponse vous est retournée au format JSON. Vous trouverez dans le champ « code » le code de retour suite à votre demande. En cas de succès, le code retour contient « OK »


En cas de succès :
code (OK) Votre demande a correctement été traitée.


En cas d'erreur provenant du formatage / de votre saisie :
ERR_100 Identifiants API non reconnus.
ERR_101 L'ID de la liste de contacts est vide.
ERR_102 Le numéro du contact est vide.
ERR_103 Aucune liste de contacts existante pour l'ID renseigné.
ERR_104 Le numéro du contact existe déjà dans la liste de contacts.
ERR_105 Le formatage du numéro du contact n'est pas valide.
ERR_106 Le pays d'origine du numéro ne correspond pas au pays de la liste de contacts.
ERR_107 Le type du numéro du contact n'est pas autorisé.


En cas d'erreur de traitement par nos services :
ERR_9XX Erreur de traitement, contactez nos services.
Une erreur de traitement interne vous est informée par un code d'erreur « ERR_9XX » soit XX = chiffres non fixes, en fonction du type d'erreur.


Une question ? Besoin d'aide ?