1Fonctionnement
Introduction
Notre API fonctionne sur le protocole HTTP(S), elle accepte des requêtes de type POST ou GET (encodées en UTF-8) et répond au format JSON. Elle est donc utilisable par tous langages capables d'effectuer une requête HTTP(S) et d'interpréter le JSON comme le PHP, ASP, Python, Java...
Pour utiliser le protocole sécurisé HTTPS, il vous suffit de modifier "http://" par "https://" dans l'adresse des pages appelées.
Important : Pour utiliser notre API envoi SMS vous devez avoir un compte client Spot-Hit (Créez un compte gratuitement). Le paramètre "key" doit être renseigné à chaque requête. Il correspond à une clé unique à récupérer sur votre compte (différente de votre mot de passe) : Récupérer ma clé API
Si vous rencontrez des problèmes lors de l'utilisation de cette API SMS, n'hésitez pas à nous contacter, vous serez mis en relation avec notre équipe technique.
Valeurs de retour
Après chaque requete effectuée, vous recevrez une réponse formatée en JSON sous le format suivant :
{resultat: [X], id: [identifiant unique de la campagne] ou erreurs: [numéro d'erreur]}
Exemple de requete acceptée :
{resultat: 1, id: 1337}
Exemple requete rejetée :
{resultat: 0, erreurs: 1,4,2}
Exemple d'utilisation avec PHP (POST et GET)
Envoi d'un SMS avec la méthode HTTP POST (cURL doit être installé) :
<?php
// Données du message
$data = array(
'key' => 'fe01ce2a7fbac8fafaed7c982a04e229',
'destinataires' => '+33600000000',
'message' => 'Hello World !',
'expediteur' => 'Spot-Hit',
'date' => '',
);
// Initialisation de cURL avec l'URL à appeler
$ch = curl_init('https://www.spot-hit.fr/api/envoyer/sms');
// Paramètres cURL pour activer le POST et retour de la réponse
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, 1);
// Passage des données
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data, '', '&'));
// Appel de l'API Spot-Hit et récupération de la réponse dans la variable $responseJson
$responseJson = curl_exec($ch);
curl_close($ch);
// Conversion JSON en tableau avec json_decode (http://fr2.php.net/manual/fr/function.json-decode.php)
$responseArray = json_decode($responseJson, true);
// Si 'resultat' == 1, le message a été envoyé correctement
if ($responseArray['resultat']) {
echo 'Message envoyé avec succès ! Identifiant unique : '.$responseArray['id'].'';
} else {
echo 'Erreur(s) : '.$responseArray['erreurs'].'';
}
Envoi d'un SMS avec la méthode HTTP GET (file_get_contents) :
Attention : le nombre de caractères dans une URL est limitée, pour effectuer des envois à un nombre important de destinataires (> 100) ou avec d'autres contenus longs (par exemple un email html), vous devez utiliser la méthode POST mentionnée ci-dessus.
Le paramètre PHP allow_url_fopen doit être activé avec "1".
<?php
// Données du message
$data = array(
'key' => 'fe01ce2a7fbac8fafaed7c982a04e229',
'destinataires' => '+33600000000',
'message' => 'Hello World !',
'expediteur' => 'Spot-Hit',
'date' => '',
);
// Conversion des données en paramètre pour une URL
// http://fr2.php.net/manual/fr/function.urlencode.php
foreach ($data as $parametre => $valeur) {
$requete .= $parametre.'='.urlencode($valeur).'&';
}
// Appel de l'API Spot-Hit et récupération de la réponse dans la variable $responseJson
$responseJson = file_get_contents('https://www.spot-hit.fr/api/envoyer/sms?'.$requete);
// Conversion JSON en tableau avec json_decode
// http://fr2.php.net/manual/fr/function.json-decode.php
$responseArray = json_decode($responseJson, true);
// Si 'resultat' == 1, le message a été envoyé correctement
if ($responseArray['resultat']) {
echo 'Message envoyé avec succès ! Identifiant unique : '.$responseArray['id'];
} else {
echo 'Erreur(s) : '.$responseArray['erreurs'];
}
2Envoyer
Envoyer un SMS
Nous vous rappelons que les horaires d’envois en France Métropolitaine pour les SMS marketing sont encadrés par la CNIL. Les flux sont autorisés du lundi au samedi de 08h00 à 22h00.
Il est par conséquent interdit d’envoyer des SMS marketing hors de ces plages horaires, ainsi que les dimanches et jours fériés toute la journée. Les envois de SMS programmés pendant ces créneaux seront par conséquent reportés à l'ouverture du prochain créneau autorisé.
En cas de non-respect de ces dispositions légales, les sanctions pénales peuvent être lourdes, l’opérateur ayant la possibilité de tracer les numéros litigieux ou contestables. Après notification et sans preuve de justificatifs de bonne foi auprès de l’opérateur, celui-ci se réserve le droit d’appliquer une pénalité dont le montant maximum est de 1000 Euros HT par manquement constaté, multiplié par le nombre de cas constatés.
URL à appeler : https://www.spot-hit.fr/api/envoyer/sms
Liste des paramètres de l'API SMS
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
message | Limité à 160 caractères (ou voir paramètre smslong). Attention : Les caractères | , ^ , € , } , { , [ , ~ , ] et \ comptent doubles.Dans une requête de type GET, utiliser le caractère \n pour effectuer un retour à la ligne.Les caractères %0A , <br> , <br /> , <br/> et \n sont automatiquement remplacés par un retour à la ligne.SMS Personnalisé : {Nom de la colonne}, exemple : {Nom} Pour rappel, afin de respecter les obligations légales de la CNIL, il est impératif d'inclure une mention de désinscription. Afin que votre campagne soit validée, il vous faut inclure la mention « STOP au 36200 » dans votre message. |
destinataires | Liste de numéros de vos destinataires (tableau ou séparé par un retour à la ligne ou une virgule) ex : +33600000000,003360-00-00-00 , 6 00 00 00 00 |
expediteur |
Optionnel 11 caractères maximum (espaces inclus) [ En savoir plus sur les règles à respecter ] Si vide, l'expéditeur de votre SMS sera un numéro court à 5 chiffres auxquels vos destinataires peuvent répondre. L’expéditeur doit comporter un minimum de 3 caractères pour être personnalisé et ne doit pas commencer par plus de 3 chiffres consécutifs avant la première lettre. L'affichage de l'expéditeur dépend du type de téléphone. Par exemple, sur certains iPhone les espaces sont supprimés. Par ailleurs, les accents et caractères spéciaux ne sont jamais pris en compte. France métropolitaine L'opérateur NRJ Mobile ne prend pas en compte les expéditeurs personnalisés, ils seront automatiquement remplacés par un numéro court. Afin d'éviter toute confusion pour vos destinataires, il est préférable de préciser le nom de votre boutique également dans le corps du message. International Certains pays n'acceptent pas la personnalisation de l'expéditeur. Il est fortement conseillé de prendre contact avec nous afin de connaître les spécificités de chaque pays concerné. Les destinataires ne pourront pas répondre au SMS lors d'envois hors France & DOM-TOM. |
date | Optionnel Date d'envoi du message (format timestamp) Si aucune date n'est entrée ou si celle-ci précède la date actuelle, le message sera envoyé immédiatement |
smslong | Optionnel Si égal à "1", autorise l'envoi de SMS supérieur à 160 caractères. Un SMS vous sera facturé tous les 153 caractères. Exemple : pour un message de 300 caractères à 1000 destinataires, 2000 SMS vous seront débités. Maximum 9 SMS concaténés (soit 1377 caractères). |
smslongnbr | Optionnel Permet de vérifier la taille du SMS long envoyé. Vous devez envoyer le nombre de SMS concaténés comme valeur. Si notre compteur nous indique un nombre différent, votre message sera rejeté. |
tronque | Optionnel Si égal à "1", tronque automatiquement le message à 160 caractères. |
encodage | Optionnel si égal à "auto", conversion de votre message en UTF-8 (il est conseillé de convertir votre message en UTF-8 dans votre application cependant si votre message reste coupé après un caractère accentué, vous pouvez activer ce paramètre). si égal à "ucs2", conversion de votre message en unicode (Vous pouvez utiliser des caractères supplémentaires comme « ê » qui n'est pas pris en compte en SMS standard, ainsi qu'inclure des emojis. Attention : Le nombre de caractères est limité à 70, et 67 en SMS Long.) |
nom | Optionnel Cette information non visible par les destinataires vous permet d’identifier votre campagne (maximum 255 caractères). |
destinataires_type | Optionnel Permet la sélection de contacts déjà enregistrés sur le compte client : « all » = sélection de tous les contacts du compte. « groupe » = sélection de tous les contacts des groupes fournis dans le champs « destinataires » (un tableau contenant les identifiants des groupes est requis) « datas » = permet d'ajouter des données personnalisées aux « destinataires » pour les utiliser dans votre message (exemple : "Bonjour {nom} {prenom}"), pour ce faire il faut que le champs « destinataires » soit un tableau de cette forme : array("+33600000001" => array("nom" => "Nom 1", "prenom" => "Prénom 1"), "+33600000002" => array("nom" => "Nom 2", "prenom" => "Prénom 2") ...) |
url | Optionnel Adresse URL de votre serveur pour la réception en "push" des statuts après l'envoi. Vous devez déjà avoir une adresse paramétrée sur votre compte pour activer les retours "push". Si ce paramètre est renseigné, cette URL sera appelée pour cet envoi sinon l'adresse du compte est utilisée. |
date_debut | Optionnel, obligatoire pour l'envoi échelonné Date de début d'envoi des messages (format timestamp) |
date_fin | Optionnel, obligatoire pour l'envoi échelonné Date de fin d'envoi des messages (format timestamp) |
creneaux | Optionnel, obligatoire pour l'envoi échelonné Heure(s) d'envois Tableau avec 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 La campagne sera fractionnée proportionnellement aux nombres de créneaux entre le jour et l'heure de démarrage, et le jour et l'heure de fin souhaitée. |
creneaux_heure | Optionnel, obligatoire pour l'envoi échelonné 1,2,3,4 ou 6 Nombre d'envoi(s) par heure |
jours | Optionnel, obligatoire pour l'envoi échelonné Tableau avec 1,2,3,4,5,6 Jours d'envoi (1 représentant lundi). Pas d'envoi le dimanche. |
timezone |
Optionnel Permet de modifier le fuseau horaire. Par défaut : Europe/Paris |
erreur_texte | Optionnel Permet de retourner le message d'erreur |
Tableau des erreurs
Envoyer un MMS
Nous vous rappelons que les horaires d'envois de messages marketing sont encadrés par la CNIL. Les flux sont autorisés du lundi au samedi de 09h00 à 21h00 (hors jours fériés).
Il est par conséquent interdit d'envoyer des messages marketing hors de ces plages horaires.
Les envois programmés dans ces plages horaires seront donc reportés au prochain créneau autorisé.
URL à appeler : https://www.spot-hit.fr/api/envoyer/mms
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
fichier | Identifiant du visuel délivré grâce à l'API d'importation de visuel MMS |
destinataires | Liste de numéros de vos destinataires (tableau ou séparé par un retour à la ligne ou une virgule) ex : +33100000000, 003340-00-00-00 , 6 00 00 00 00 |
sujet | Optionnel Sujet de votre MMS |
message | Limité à 10000 caractères |
date | Optionnel Date d'envoi du message (format timestamp) Si aucune date n'est entrée ou si celle-ci précède la date actuelle, le message sera envoyé immédiatement |
destinataires_type | Optionnel Permet la sélection de contacts déjà enregistrés sur le compte client : « all » = sélection de tous les contacts du compte. « groupe » = sélection de tous les contacts du groupe id fournit dans le champs « destinataires » |
nom | Optionnel Cette information non visible par les destinataires vous permet d’identifier votre campagne (maximum 255 caractères). |
date_debut | Optionnel, obligatoire pour l'envoi échelonné Date de début d'envoi des messages (format timestamp) |
date_fin | Optionnel, obligatoire pour l'envoi échelonné Date de fin d'envoi des messages (format timestamp) |
creneaux | Optionnel, obligatoire pour l'envoi échelonné Heure(s) d'envois Tableau avec 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 La campagne sera fractionnée proportionnellement aux nombres de créneaux entre le jour et l'heure de démarrage, et le jour et l'heure de fin souhaitée. |
creneaux_heure | Optionnel, obligatoire pour l'envoi échelonné 1,2,3,4 ou 6 Nombre d'envoi(s) par heure |
jours | Optionnel, obligatoire pour l'envoi échelonné Tableau avec 1,2,3,4,5,6 Jours d'envoi (1 représentant lundi). Pas d'envoi le dimanche. |
timezone |
Optionnel Permet de modifier le fuseau horaire. Par défaut : Europe/Paris |
erreur_texte | Optionnel Permet de retourner le message d'erreur |
Tableau des erreurs
Importer un visuel MMS
Votre image sera automatiquement réduite en taille afin de ne pas dépasser la taille maximum de 240ko.
La qualité peut être dégradée par cette réduction, il est important d’effectuer un envoi de MMS d’essai sur votre téléphone mobile avant de valider votre campagne.
URL à appeler : https://www.spot-hit.fr/api/mms/upload
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
fichier | Votre fichier au format PNG, GIF ou JPG (5 mo maximum) |
Résultats
Résultat | Description |
---|---|
{"success":true,"file":"1234","pages":6} | success = true = Elément importé avec succès file = identifiant de votre fichier pages = nombre de pages de votre fichier |
{"success":false,"msg":"Message erreur."} | success = false = Elément non importé msg = message d'erreur |
Envoyer un Email
URL à appeler : https://www.spot-hit.fr/api/envoyer/e-mail
Liste des paramètres de l'API email
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
sujet | Intitulé du mail qui sera affiché dans la boîte de réception de vos destinataires. |
message | Contenu de votre email. (Format HTML) |
destinataires | Liste d'emails de vos destinataires (tableau ou séparé par un retour à la ligne ou une virgule) |
expediteur | Adresse d'expédition des emails. Attention pour une meilleure dérivabilité vous devez utiliser un domaine référencé sur Spot-Hit. Par défaut nous mettons à votre disposition le domaine sh-mail.fr. Exemple : [email protected] |
nom_expediteur | S'affiche en complément de l'adresse email d'expédition, corresponds à l'affichage de votre Nom et Prénom lorsque vous envoyez un email personnel. |
email_reponse | Optionnel Email de redirection des réponses. |
date | Optionnel Date d'envoi du message (format timestamp) Si aucune date n'est entrée ou si celle-ci précède la date actuelle, le message sera envoyé immédiatement |
type_message | Optionnel Permet la sélection d'un template déjà enregistré sur le compte client : «creation» = sélection du template avec le template id fournit dans le champs « message » |
destinataires_type | Optionnel Permet la sélection de contacts déjà enregistrés sur le compte client : « all » = sélection de tous les contacts du compte. « groupe » = sélection de tous les contacts du groupe id fournit dans le champs « destinataires » « datas » = permet d'ajouter des données personnalisées aux « destinataires » pour les utiliser dans votre message (exemple : "Bonjour {nom} {prenom}"), pour ce faire il faut que le champs « destinataires » soit un tableau de cette forme : array("[email protected]" => array("nom" => "Nom 1", "prenom" => "Prénom 1"), "[email protected]" => array("nom" => "Nom 2", "prenom" => "Prénom 2") ...) |
nom | Optionnel Cette information non visible par les destinataires vous permet d’identifier votre campagne. |
fichiers | Optionnel Liste d'id de fichiers (tableau ou séparé par une virgule) 5 maximum. Vous pouvez retrouver les ids des catégories de la médiathèque : "Mes Fichiers", "Fichiers partagés", "Mes fichiers privés" En survolant les fichiers avec la souris. |
date_debut | Optionnel, obligatoire pour l'envoi échelonné Date de début d'envoi des messages (format timestamp) |
date_fin | Optionnel, obligatoire pour l'envoi échelonné Date de fin d'envoi des messages (format timestamp) |
creneaux | Optionnel, obligatoire pour l'envoi échelonné Heure(s) d'envois Tableau avec 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 La campagne sera fractionnée proportionnellement aux nombres de créneaux entre le jour et l'heure de démarrage, et le jour et l'heure de fin souhaitée. |
creneaux_heure | Optionnel, obligatoire pour l'envoi échelonné 1,2,3,4 ou 6 Nombre d'envoi(s) par heure |
jours | Optionnel, obligatoire pour l'envoi échelonné Tableau avec 1,2,3,4,5,6 Jours d'envoi (1 représentant lundi). Pas d'envoi le dimanche. |
alternatif | Optionnel Le texte alternatif améliore votre délivrabilité et permet aux destinataires d’avoir un aperçu du contenu si le HTML est désactivé sur la messagerie. Vous pouvez écrire une version uniquement texte et sans variable de votre e-mail. |
timezone |
Optionnel Permet de modifier le fuseau horaire. Par défaut : Europe/Paris |
erreur_texte | Optionnel Permet de retourner le message d'erreur |
Tableau des erreurs
Importer une pièce jointe
URL à appeler : https://www.spot-hit.fr/api/email/upload
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
fichier | Fichier que vous souhaitez importer. Formats acceptés : 'pdf', 'doc', 'docx', 'odt', 'xls', 'xlsx', 'csv', 'txt' (5Mb maximum) |
private | Optionnel Si égal à "1", permet que le fichier soit enregistré dans "Mes fichiers privés" plutôt que dans "Mes fichiers" |
Résultats
Résultat | Description |
---|---|
{"success":true,"file":"1234"} | success = true = Elément importé avec succès file = identifiant de votre fichier |
{"success":false,"msg":"Message erreur."} | success = false = Elément non importé msg = message d'erreur |
Envoyer un Message Vocal
Nous vous rappelons que l'envoi de messages commerciaux est formellement interdit en France Métropolitaine pendant les heures comprises entre 22h00 et 8h00 les jours calendaires, le dimanche toute la journée et les jours fériés.
En cas de non-respect de ces dispositions légales, les sanctions pénales peuvent être lourdes, l’opérateur ayant la possibilité de tracer les numéros litigieux ou contestables. Après notification et sans preuve de justificatifs de bonne foi auprès de l’opérateur, celui-ci se réserve le droit d’appliquer une pénalité dont le montant maximum est de 1000 Euros HT par manquement constaté, multiplié par le nombre de cas constatés.
URL à appeler : https://www.spot-hit.fr/api/envoyer/vocal
Liste des paramètres de l'API envoi message vocal
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
type | Type de Message Vocal : "direct_repondeur" ou "appels" Direct Répondeur : message vocal déposé directement sur le répondeur sans faire sonner Appels : message diffusé au décroché d'un appel entrant vers les numéros destinataires |
message | Identifiant du message audio délivré grâce à l'API d'importation de fichier audio ou via le serveur vocal en appelant le 01 81 90 40 00 (direct_repondeur) ou le 01 81 90 50 05 (appels) |
destinataires | Liste de numéros de vos destinataires (tableau ou séparé par un retour à la ligne ou une virgule) ex : +33100000000, 003340-00-00-00 , 6 00 00 00 00 |
expediteur | Optionnel Numéro de téléphone valide Si vide, l'expéditeur sera "Numéro inconnu" ou équivalent. |
date | Optionnel Date d'envoi du message (format timestamp) Si aucune date n'est entrée ou si celle-ci précède la date actuelle, le message sera envoyé immédiatement |
destinataires_type | optionnel Permet la sélection de contacts déjà enregistrés sur le compte client : « all » = sélection de tous les contacts du compte. « groupe » = sélection de tous les contacts du groupe id fournit dans le champs « destinataires » |
fixe | Optionnel (uniquement pour Appels) Si égal à "0", ignore les numéros de téléphones fixes. |
detection_repondeur | Optionnel (uniquement pour Appels) Si égal à "1" et le cas où l'appel est décroché par un répondeur, ce paramètre permet d'activer le dépot sur répondeur. |
reecoute | Optionnel (uniquement pour Appels) Si égal à "1" rajoute à la fin de votre message un choix permettant au destinataire de réécouter votre message. |
mise_relation | Optionnel (uniquement pour Appels) Numéro de téléphone valide. Permet au destinataire d'être mis en relation avec le numéro spécifié. |
boite_vocale | Optionnel (uniquement pour Appels) Si égal à "1", rajoute à la fin de votre message une boîte vocale permettant au destinataire de vous laisser un message. |
stop | Optionnel (uniquement pour Appels) Si égal à "1", rajoute à la fin de votre message un choix permettant au destinataire de s'opposer à la réception de messages de votre part. |
nom | Optionnel Cette information non visible par les destinataires vous permet d’identifier votre campagne (maximum 255 caractères). |
url | Optionnel Adresse URL de votre serveur pour la réception en "push" des statuts après l'envoi. Vous devez déjà avoir une adresse paramétrée sur votre compte pour activer les retours "push". Si ce paramètre est renseigné, cette URL sera appelée pour cet envoi sinon l'adresse du compte est utilisée. |
date_debut | Optionnel, obligatoire pour l'envoi échelonné Date de début d'envoi des messages (format timestamp) |
date_fin | Optionnel, obligatoire pour l'envoi échelonné Date de fin d'envoi des messages (format timestamp) |
creneaux | Optionnel, obligatoire pour l'envoi échelonné Heure(s) d'envois Tableau avec 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 La campagne sera fractionnée proportionnellement aux nombres de créneaux entre le jour et l'heure de démarrage, et le jour et l'heure de fin souhaitée. |
creneaux_heure | Optionnel, obligatoire pour l'envoi échelonné 1,2,3,4 ou 6 Nombre d'envoi(s) par heure |
jours | Optionnel, obligatoire pour l'envoi échelonné Tableau avec 1,2,3,4,5,6 Jours d'envoi (1 représentant lundi). Pas d'envoi le dimanche. |
timezone |
Optionnel Permet de modifier le fuseau horaire. Par défaut : Europe/Paris |
erreur_texte | Optionnel Permet de retourner le message d'erreur |
Tableau des erreurs
Importer un fichier audio
URL à appeler : https://www.spot-hit.fr/api/vocal/upload
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
fichier | Votre fichier au format WAV, MP3 ou M4A (6 mo maximum) avec une durée entre 15 et 55 secondes |
Résultats
Résultat | Description |
---|---|
{"success":true,"file":"1234","duree":30} | success = true = Elément importé avec succès file = identifiant de votre fichier duree = durée du fichier en secondes |
{"success":false,"msg":"Message erreur."} | success = false = Elément non importé msg = message d'erreur |
Attention !
Les fichiers importés ne seront conservés que 7 jours. Passé ce délai, ils seront automatiquement supprimés.
Envoyer un Fax
URL à appeler : https://www.spot-hit.fr/api/envoyer/fax
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
message | Identifiant du PDF délivré grâce à l'API d'importation de PDF |
destinataires | Liste de numéros de vos destinataires (tableau ou séparé par un retour à la ligne ou une virgule) ex : +33100000000, 003340-00-00-00 , 6 00 00 00 00 |
expediteur | Optionnel Nom de l'expéditeur |
date | Optionnel Date d'envoi du message (format timestamp) Si aucune date n'est entrée ou si celle-ci précède la date actuelle, le message sera envoyé immédiatement |
destinataires_type | Optionnel Permet la sélection de contacts déjà enregistrés sur le compte client : « all » = sélection de tous les contacts du compte. « groupe » = sélection de tous les contacts du groupe id fournit dans le champs « destinataires » |
nom | Optionnel Cette information non visible par les destinataires vous permet d’identifier votre campagne (maximum 255 caractères). |
timezone |
Optionnel Permet de modifier le fuseau horaire. Par défaut : Europe/Paris |
Tableau des erreurs
Importer un PDF
URL à appeler : https://www.spot-hit.fr/api/pdf/upload
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
fichier | Votre fichier au format PDF (6 mo maximum) |
Résultats
Résultat | Description |
---|---|
{"success":true,"file":"1234","pages":6} | success = true = Elément importé avec succès file = identifiant de votre fichier pages = nombre de pages de votre fichier |
{"success":false,"msg":"Message erreur."} | success = false = Elément non importé msg = message d'erreur |
3Erreurs
Tableau des erreurs
Voici la liste des erreurs associées aux différents types d'envois
Code erreur | Description |
---|---|
1 | Type de message non spécifié ou incorrect (paramètre "type") |
2 | Le message est vide |
3 | Le message contient plus de 160 caractères (70 en unicode) |
4 | Aucun destinataire valide n'est renseigné |
5 | Numéro interdit |
6 | Numéro de destinataire invalide |
7 | Votre compte n'a pas de formule définie |
8 | SMS | L'expéditeur est invalide. VOCAL | L'expéditeur est invalide. EMAIL | L'e-mail d'expédition est invalide. MMS | Le sujet contient plus de 16 caractères. |
9 | Le système a rencontré une erreur, merci de nous contacter. |
10 | Vous ne disposez pas d'assez de crédits pour effectuer cet envoi. |
11 | L'envoi des message est désactivé pour la démonstration. |
12 | Votre compte a été suspendu. Contactez-nous pour plus d'informations |
13, 14, 15 | Votre limite d'envoi paramétrée est atteinte. Contactez-nous pour plus d'informations. |
16 | Le paramètre "smslongnbr" n'est pas cohérent avec la taille du message envoyé. |
17 | L'expéditeur n'est pas autorisé. |
18 | EMAIL | Le sujet est trop court. |
19 | EMAIL | L'email de réponse est invalide. |
20 | EMAIL | Le nom d'expéditeur est trop court. |
21 | Token invalide. Contactez-nous pour plus d'informations. |
22 | Durée du message non autorisée. Contactez-nous pour plus d'informations. |
23 | Aucune date variable valide n'a été trouvée dans votre liste de destinataires. |
24 | Votre campagne n'a pas été validée car il manque la mention « STOP au 36200 » dans votre message. Pour rappel, afin de respecter les obligations légales de la CNIL, il est impératif d'inclure une mention de désinscription. |
25 | Echelonnage : date de début vide |
26 | Echelonnage : date de fin vide |
27 | Echelonnage : date de début plus tard que date de fin |
28 | Echelonnage : aucun créneau disponible |
29 | MMS :
Le mot "virtual" peut générer des anomalies dans le routage de vos messages. Nous vous invitons à utiliser un synonyme ou une autre écriture (Virtuel par exemple). Nous sommes en train de corriger cette anomalie, veuillez-nous excuser pour la gêne occasionnée. |
30 | Clé API non reconnue. |
36 | Vous ne pouvez pas avoir d'emojis dans votre message. |
38 | Vous devez ajouter une mention "Stop" à votre SMS. |
40 | Une pièce jointe ne vous appartient pas. |
41 | Une pièce jointe est invalide. |
45 | Ce produit n'est pas activé. |
50 | Le fuseau horaire spécifié n'est pas valide. |
51 | La date est déjà passée après calcule du fuseau horaire. |
52 | Vous avez atteint la limite maximale de 50 campagnes en brouillons. Si vous souhaitez en ajouter plus, merci de nous contacter. |
53 | Nous limitons à 5 pièces jointes par campagne email. |
61 | Nous avons détecté un lien dans le contenu de votre message, merci de vous rapprocher de notre service client pour valider cet envoi. |
62 | Votre limite d'envoi est atteinte. |
63 | Vous avez dépassé votre limite de requêtes api. |
65 | Une maintenance est prévu sur ce créneaux horaire. |
66 | Nous avons bloqué préventivement cette campagne car elle présente des caractéristiques similaires à une campagne déjà envoyée (contenu, destinataires...). Merci de nous contacter pour plus d'informations. |
99 | Votre compte est suspendu. |
100 | Ip non autorisée. |
4Suivi
Liste des accusés de réception
URL à appeler : https://www.spot-hit.fr/api/dlr
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | ID de la campagne |
produit | Canal de la campagne (sms,vocal,email,mms,fax) |
Résultats
Résultat |
---|
[ ["+33600000000","1","1323257035","1323257040", "178", "245645656", "20801"], ["+33600000000","1","1323257035","1323257040", "178", "245645656", "20801"] ... ] |
{resultat: 0, id:, erreurs: "1"} |
Correspondance
Eléments | Description |
---|---|
[numero] | Numéro du destinataire |
[statut] | Statut du message
1 = Envoyé et bien reçu Le message a bien été livré sur un mobile allumé. 2 = Envoyé et non reçu Le message a bien été envoyé sur un numéro valide, mais le mobile est pour l’instant injoignable (éteint, pas de réseau, SIM pleine...). Durant 48h, les opérateurs essayent de livrer à nouveau le message sur le mobile. Si ce dernier reste injoignable après ce délai, le statut se transformera en « expiré ». 3 = En cours Le message est en cours d'envoi, ce statut évoluera rapidement. 4 = Echec Le message a expiré, car le mobile du destinataire reste injoignable après 48h. Le numéro de téléphone est annoncé valide par les opérateurs, si le mobile est de nouveau joignable lors des prochaines campagnes le message sera correctement reçu. 5 = Expiré Le message n'a pas pu être délivré, car le numéro est annoncé inaccessible par les opérateurs. (Les statuts 1, 4 et 5 sont définitifs.) |
[date_emission] | Date d'émission du message (UNIX timestamp) |
[date_mise_a_jour] | Date du dernier changement de statut du message (UNIX timestamp) |
[statut_detaille] | Statut détaillé du message (disponible auprès de votre gestionnaire de compte). |
[id_message] | Identifiant du message. |
[operateur] | Code MCCMNC correspondant à l'opérateur du destinataire. |
Eléments | Description |
---|---|
[numero] | Numéro du destinataire |
[statut] | Statut du message
0 = En attente Le MMS est en attente d'envoi, généralement il concerne une campagne programmée. 1/2 = Envoyé Le MMS a bien été transmis aux opérateurs, qui se chargent de le transmettre aux téléphones mobiles. Toutefois, nous n'avons pas d'accusés de réception détaillés. 3 = En cours Le MMS est en cours d'envoi, ce statut évoluera rapidement. 4 = Echec Le MMS n'a pas pu être délivré, car le numéro est annoncé inaccessible par les opérateurs. |
[date_emission] | Date d'émission du message (UNIX timestamp) |
[date_mise_a_jour] | Date du dernier changement de statut du message (UNIX timestamp) |
[statut_detaille] | Statut détaillé du message (disponible auprès de votre gestionnaire de compte). |
[id_message] | Identifiant du message. |
Eléments | Description |
---|---|
[numero] | Numéro du destinataire |
[statut] | Statut du message
1 = En cours Le message est en cours d'envoi, ce statut évoluera rapidement. 2 = Envoyé L'email a bien été envoyé vers une adresse valide, mais n'a pas encore été ouvert. 3 = Cliqué Le destinataire a cliqué sur un lien présent dans l'email. (Les prévisualisations et les désinscriptions ne sont pas prises en compte). 4 = Echec Le message n'a pas pu être délivré, un bounce détaille le problème. 5 = Bloqué L'adresse a été bloquée préventivement car cet email n'a aucune chance d'arriver en boîte de réception. 8 = Ouvert Le destinaire a ouvert l'email. |
[bounce] | Catégorie du bounce
1 = bad_connection 2 = policy_related 3 = message_expired 4 = bad_mailbox 5 = bad_domain 6 = inactive_mailbox 7 = routing_errors 8 = quota_issues 9 = relaying_issues 10 = no_answer_from_host 11 = antispam_feedback 12 = other 13 = spam_related 14 = invalid_sender |
[date_emission] | Date d'émission du message (UNIX timestamp) |
[date_mise_a_jour] | Date du dernier changement de statut du message (UNIX timestamp) |
[statut_detaille] | Statut détaillé du message (disponible auprès de votre gestionnaire de compte). |
[id_message] | Identifiant du message. |
Eléments | Description |
---|---|
[numero] | Numéro du destinataire |
[statut] | Statut du message
1 = Envoyé et bien reçu Le message a bien été livré sur un mobile allumé. 2 = Envoyé et non reçu Le message a bien été envoyé sur un numéro valide, mais le mobile est pour l’instant injoignable (éteint, pas de réseau, SIM pleine...). Durant 48h, les opérateurs essayent de livrer à nouveau le message sur le mobile. Si ce dernier reste injoignable après ce délai, le statut se transformera en « expiré ». 3 = En cours Le message est en cours d'envoi, ce statut évoluera rapidement. 4 = Echec Le message a expiré, car le mobile du destinataire reste injoignable après 48h. Le numéro de téléphone est annoncé valide par les opérateurs, si le mobile est de nouveau joignable lors des prochaines campagnes le message sera correctement reçu. 5 = Expiré Le message n'a pas pu être délivré, car le numéro est annoncé inaccessible par les opérateurs. (Les statuts 1, 4 et 5 sont définitifs.) |
[date_emission] | Date d'émission du message (UNIX timestamp) |
[date_mise_a_jour] | Date du dernier changement de statut du message (UNIX timestamp) |
[statut_detaille] | Statut détaillé du message (disponible auprès de votre gestionnaire de compte). |
[id_message] | Identifiant du message. |
[operateur] | Code MCCMNC correspondant à l'opérateur du destinataire. |
Eléments | Description |
---|---|
[numero] | Numéro du destinataire |
[statut] | Statut du message
0 = En attente Le FAX est en attente d'envoi, généralement il concerne une campagne programmée. 1 = Envoye Le message a bien été envoyé. 2/4 = Echec Le message n'a pas pu être délivré, un bounce détaille le problème. 3 = En cours Le message est en cours d'envoi, ce statut évoluera rapidement. 5 = Expiré Le message n'a pas pu être délivré. |
[date_emission] | Date d'émission du message (UNIX timestamp) |
[date_mise_a_jour] | Date du dernier changement de statut du message (UNIX timestamp) |
[statut_detaille] | Statut détaillé du message (disponible auprès de votre gestionnaire de compte). |
[id_message] | Identifiant du message. |
Tableau des erreurs
Numéro | Description |
---|---|
1 | ID non valide |
2 | Une campagne en création ou en cours d'envoi |
3 | Aucune campagne avec cet ID n'a été trouvée pour ce compte |
Réception (PUSH) des statuts
URL à appeler : Vous devez paramétrer sur votre compte l'adresse que notre plate-forme appellera à chaque changement de statut. Accès rapide aux paramètres
Paramètres (GET)
Paramètre | Description |
---|---|
id_accuse | Identifiant unique du message pour ce numéro. |
id_message | Identifiant commun en cas d'envoi d'un message groupé. |
numero | Optionnel, numéro de téléphone du destinataire (uniquement si le produit est de type sms, vocal, fax, mms). |
Optionnel, email du destinataire (uniquement si le produit est de type email). | |
statut |
Statut du message SMS
0 = En attente Le SMS est en attente d'envoi, généralement il concerne une campagne programmée. 1 = Livré Le SMS a bien été livré sur un mobile allumé. Avec 95% de taux de lecture moyen (étude Médiamétrie AFMM), il est fort probable qu'il soit également lu par le destinataire dans les minutes qui suivent la réception. 2 = Envoyé Le SMS a bien été envoyé sur un numéro valide, mais le mobile est pour l’instant injoignable (éteint, pas de réseau, SIM pleine...). Durant 48h, les opérateurs essayent de livrer à nouveau le SMS sur le mobile. Si ce dernier reste injoignable après ce délai, le statut se transformera en « expiré ». 3 = En cours Le SMS est en cours d'envoi, ce statut évoluera rapidement. 4 = Echec Le SMS a expiré, car le mobile du destinataire reste injoignable après 48h. Le numéro de téléphone est annoncé valide par les opérateurs, si le mobile est de nouveau joignable lors des prochaines campagnes le SMS sera correctement reçu. 5 = Expiré Le SMS n'a pas pu être délivré, car le numéro est annoncé inaccessible par les opérateurs. (Les statuts 1, 4 et 5 sont définitifs.) Statut du message Email 0 = En attente L'email est en attente d'envoi. (Généralement il concerne une campagne programmée). 2 = Envoyé L'email a bien été envoyé vers une adresse valide, mais n'a pas encore été ouvert. 3 = Cliqué Le destinataire a cliqué sur un lien présent dans l'email. (Les prévisualisations et les désinscriptions ne sont pas prises en compte). 4 = Erreur Il s'agit d'un problème temporaire comme une boite de réception pleine ou un problème d'acheminement ou d'un problème permanent comme une adresse invalide. 5 = Bloqué L'adresse a été bloquée préventivement car cet email n'a aucune chance d'arriver en boîte de réception. 6 = Spam L'email a été bloqué par un système de protection installé sur l'adresse du destinataire (MailInBlack, ALTOSPAM, ...). 7 = Desabonné Le destinataire de l'email est présent dans votre liste d'exclusion. 8 = Ouvert Le destinaire a ouvert l'email. |
date_envoi | Date d'envoi du message (timestamp). |
date_update | Date de dernière mise à jour du statut (timestamp). |
statut_code | Statut détaillé de 0 à 9999 (détails à demander à votre gestionnaire de compte). |
nom | Le nom ou l'identifiant personnel de votre message |
liens | Optionnel, liste des liens cliqués (uniquement si le produit est de type email |
produit | Le produit de votre message (email, sms, vocal, mms, fax) |
bounce_category | Optionnel, categorie du bounce (uniquement si message de type e-mail et qu'il y a un bounce). |
Liste des messages
URL à appeler : https://www.spot-hit.fr/api/campaign/list
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
date_start | Timestamp date de début de la sélection |
date_end | Timestamp date de fin de la sélection. (Ecart max d'un an entre la date de début et date de fin) |
product | Type de produit ciblé (sms, email, mms, vocal) |
destinataires |
Optionnel, si égal à "1", ajoute la liste des destinataires dans le retour sinon la liste est vide. Par défaut = 0 |
limit | Optionnel, nombre de résultats maximum dans la sélection (max : 10 000) |
start | Optionnel, point de départ de la séléction |
id | Optionnel, sélection unique du message correspondant à l'identifiant fourni |
Résultats
Résultat |
---|
[ [455]["Contenu du message"]["+33600000000,+33600000000"][2][15805646456][2]["Expéditeur"]["premium"][15805646456]["Ma campagne"] [55]["Contenu du message"]["+33600000000,+33600000000"][2][15805646456][2]["Expéditeur"]["premium"][15805646456]["Ma campagne 2"] ... ] |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Produit incorrect |
2 | Veuillez préciser une date de début |
3 | Veuillez préciser une date de fin |
4 | La période est supérieure à un an |
Correspondance
Eléments | Description |
---|---|
[id] | Identifiant unique |
[message] | Contenu du message |
[liste_destinataires] | Liste des destinataires séparés par des virgules |
[nbr_destinataires] | Nombre de destinataires |
[date] | Timestamp date d'envoi |
[statut] | Statut d'envoi du message [0 = Programmé, 1 = En cours, 2 = Envoyé , 3 = Echec] |
[expediteur] | Expéditeur du message |
[type] | Type de message |
[date_ajout] | Timestamp date d'ajout |
[nom] | Votre identifiant de message |
Modifier un message
URL à appeler : https://www.spot-hit.fr/api/campaign/edit
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
date | Nouvelle date d'envoi (timestamp) Si vide ou invalide = envoi immédiat |
id | ID du message à modifier |
product | Produit de la campagne |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément modifié avec succès |
{resultat: 0, erreurs: [1,2]} | resultat = 0 = Erreur lors de la modification erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | ID non existant |
2 | Message déjà envoyé et donc non modifiable |
3 | Vous êtes sur un compte démo |
4 | Produit incorrect |
SUPPRIMER UN MESSAGE
URL à appeler : https://www.spot-hit.fr/api/campaign/delete
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | ID du message à supprimer |
product | Produit du message |
Résultats
Résultat | Description |
---|---|
{resultat: true} | resultat = true = Elément supprimé avec succès |
{resultat: false, erreurs: [1,2] | resultat = false = Erreur lors de la suppression erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Vous ne pouvez pas supprimer cette campagne vocale, contactez le service client. |
2 | Le produit est inconnu, veuillez le vérifier |
3 | Erreur lors de la suppression de votre campagne. |
4 | Vous ne pouvez pas supprimer ce type de campagne, contactez le service technique pour plus d'informations. |
5 | Vous ne pouvez pas supprimer cette campagne car elle est envoyée, contactez le service technique pour plus d'informations. |
6 | ID non existant. |
5Modèles
Liste des modèles
URL à appeler : https://www.spot-hit.fr/api/sms/models
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat |
---|
[ [455]["Modèle 1"]["Exemple de modèle"] [575]["Modèle 2"]["Exemple de modèle"] ... ] |
Correspondance
Eléments | Description |
---|---|
[id] | Identifiant unique |
[nom] | Nom du modèle |
[message] | Contenu du modèle |
Ajouter un modèle
URL à appeler : https://www.spot-hit.fr/api/sms/model/add
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
nom | Nom du modèle |
message | Contenu du modèle SMS Personnalisé : {Nom du critère} |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 45498} | resultat = 1 = Elément ajouté avec succès. id = Identifiant unique de l'élément |
{resultat: 0, erreurs: "1,2,3,4"} | resultat = 0 = Erreur lors de l'ajout. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Le nom est vide |
2 | Le message contient plus de 160 caractères |
3 | Le message est vide |
4 | Le système a rencontré une erreur, merci de nous contacter |
Modifier un modèle
URL à appeler : https://www.spot-hit.fr/api/sms/model/edit
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
message | Contenu du modèle |
id | Identifiant du modèle à modifier |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément modifié avec succès |
{resultat: 0, erreurs: "1,2,3,4"} | resultat = 0 = Erreur lors de la modification. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Identifiant inexistant |
2 | Le message contient plus de 160 caractères |
3 | Le message est vide |
4 | Le système a rencontré une erreur, merci de nous contacter |
Supprimer un modèle
URL à appeler : https://www.spot-hit.fr/api/sms/model/delete
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant de l'élement à supprimer |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément supprimé avec succès |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de la suppression. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Identifiant inexistant |
2 | Le système a rencontré une erreur, merci de nous contacter |
6Médias
Liste des médias
URL à appeler : https://www.spot-hit.fr/api/medias/lister
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
output | Optionnel Permet de filtrer le type de média : 0 : Site Mobile 1 : Maquette Email 3 : Maquette importées |
get-html | Optionnel Permet de récupérer le html de chaque maquette email |
Résultats
Résultat |
---|
[ {"id": 455,"thumbnail":"https://www.spot-hit.fr/uploads/outilmedia/thumbnails/no-thumbnail-available.png","output": 1,"name":"Modèle 1","date_creation": 1327843894,"date_update": 1327843894,"is_online": true }, {"id": 575,"thumbnail":"https://www.spot-hit.fr/uploads/outilmedia/thumbnails/no-thumbnail-available.png","output": 0,"name":"Modèle 2","date_creation": 1327843894,"date_update": 1327843894,"is_online": true }, ... ] |
Correspondance
Eléments | Description |
---|---|
[id] | Identifiant unique |
[thumbnail] | Url de l'icon |
[output] | 0: Site mobile 1: Maquette email |
[name] | Nom du média |
[date_creation] | Date de création du média |
[date_update] | Date de mise à jour du média |
[is_online] | Site mobile en ligne ou pas |
Récupérer le html d'un média email
URL à appeler : https://www.spot-hit.fr/api/media/get-html
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Id du média |
Résultats
Résultat | Description |
---|---|
{"resultat": 1, "preview": "!DOCTYPE[...]"} | resultat = 1 = Html du média récupéré avec succès. preview = Html du contenu du média |
{"resultat": false, "erreurs": "1,2"} | resultat = 0 = Erreur lors de la récupération du html du média. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Ce n'est pas une maquette email |
2 | Cette maquette email n'existe pas. |
7Contacts
Liste des contacts
URL à appeler : https://www.spot-hit.fr/api/contacts/get
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
format | "json" (ou "html", non conseillé) |
nbr | Le nombre maximum de contacts que vous souhaitez récupérer (ne pas renseigner pour prendre tous les contacts) |
groupe | Renseigner l'ID d'un de vos groupes si vous souhaitez seulement cibler les contacts présent dans ce groupe |
Résultats
Résultat |
---|
{ "total":2, "colonnes":{"9696":"Prénom","9697":"Nom","27728":"Champs personnalisé"}, "donnees": [ {"id":"28577127","numero":"+33600000001","groupe":"30522","email":"[email protected]","fixe":"","fax":"","groupe_nom":"Groupe test","c_champs personnalise":"Contenu champs personnalisé""c_nom":"Nom 1""c_prenom":"Prénom 1"}, {"id":"28577128","numero":"+33600000002","groupe":"30522","email":"[email protected]","fixe":"","fax":"","groupe_nom":"Groupe test","c_champs personnalise":"Contenu champs personnalisé""c_nom":"Nom 2""c_prenom":"Prénom 2"} ... ] } |
Ajouter un contact
URL à appeler : https://www.spot-hit.fr/api/contacts/import
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
contacts |
Tableau des contacts contacts[0][nom]=Nom 1 contacts[0][prenom]=Prénom 1 contacts[0][mobile]=+33600000001 contacts[0][fixe]=+33100000001 contacts[0][fax]=+33200000001 contacts[0][email][email protected] contacts[0][custom_id]=123456 contacts[0][Champs+Personnalise]=Contenu champs personnalisé contacts[0][Champs+Personnalise+2]=Contenu champs personnalisé contacts[1][prenom]=Prénom 2 contacts[1][mobile]=+33600000002 contacts[1][fixe]=+33100000002 contacts[1][fax]=+33200000002 contacts[1][email][email protected] contacts[1][custom_id]=123457 contacts[1][Champs+Personnalise]=Contenu champs personnalisé contacts[1][Champs+Personnalise+2]=Contenu champs personnalisé |
groupe_id | ID du groupe dans lequel doivent se situer les contacts Renseigner 0 si création d'un nouveau groupe |
groupe_nom | Optionnel, nom du groupe à créer. groupe_id doit etre renseigné à 0 |
remplacer_groupe | Défaut = 0, si égal à 1, remplace les contacts déjà présents dans le groupe |
ajouter_autres_groupes | Défaut = 0, si égal à 1, ajoute les contacts même si ils sont déjà présents dans un autre groupe |
supprimer_internationaux | Défaut = 0, si égal à 1, supprime les numéros non Français |
indicatif | Défaut = 33, (France), indicatif des numéros sans indicatif renseigné |
Résultats
Résultat | Description |
---|---|
{resultat: 1, nbr_ajouts: 2, groupe: 1000, contacts_id: {123456478,132465464} | resultat = 1 = Elément ajouté avec succès nbr_ajouts = Nombre contacts ajoutés groupe = ID du groupe contacts_id = Liste d'id des contacts ajoutés |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de l'import erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Impossible de créer le groupe ou groupe déjà existant |
2 | Contacts vides ou contacts illisibles |
Modifier un contact
URL à appeler : https://www.spot-hit.fr/api/contacts/edit-contact
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | ID du contact à modifier |
colonnes | Tableau avec le nom de la colonne et de la valeur souhaité. Exemple de noms de colonnes : "mobile" "fixe" "email" "custom_id" "Champs+Personnalise" |
custom_id | Mettre à 1 si l'id est personnalisé |
groupe | Id du groupe afin de cibler l'id personnalisé |
Résultats
Résultat | Description |
---|---|
{resultat: true, id : XXX, contact : {colonne : XXX} } | resultat = true = Elément supprimé avec succès |
{resultat: false, erreurs: "Aucune colonne n'a été trouvé", code_erreurs: {1}} | resultat = false = Erreur lors de la mise à jour du contact. erreurs = Message d'erreur code_erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Le contact n'a pas été trouvé |
2 | Aucune colonne n'a été trouvée |
3 | Aucun id n'a été renseigné. |
Modifier des contacts
URL à appeler : https://www.spot-hit.fr/api/contacts/edit-contacts
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
contacts | Tableau de contacts avec l'id en clé et en valeur un tableau avec le nom de la colonne et de la valeur souhaité. Si une colonne n'existe pas elle ne sera pas créée Exemple de noms de colonnes : "mobile" "fixe" "email" "custom_id" "Champs+Personnalise" |
custom_id | Mettre à 1 si les ids sont personnalisés |
Résultats
Résultat | Description |
---|---|
{ 0: {resultat: true, id : XXX, contact : {colonne : XXX} } } | resultat = true = Elément supprimé avec succès |
{ 0: {resultat: false, erreurs: {1,2} } | resultat = false = Erreur lors de la mise à jour du contact. erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | "Contacts" doit être un tableau |
2 | Aucune colonne n'a été trouvée |
3 | Aucun id n'a été renseigné. |
4 | Le système à rencontré une erreur, merci de nous contacter. |
Supprimer un contact
URL à appeler : https://www.spot-hit.fr/api/contact/supprimer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Id du contact à supprimer |
custom_id | Mettre à 1 si l'id utilisé est un id personnalisé |
groupe | Id du groupe pour cibler l'id personnalisé |
Résultats
Résultat | Description |
---|---|
{resultat: true} | resultat = true = Contact supprimé avec succès |
{resultat: false, erreurs: {1,2} | resultat = false = Erreur lors de la suppression du contact. erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id vide ou non existante |
2 | Le système a rencontré une erreur, merci de nous contacter |
Supprimer plusieurs contacts
URL à appeler : https://www.spot-hit.fr/api/contacts/supprimer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
ids | Id des contacts sous forme de tableau ou séparés par une virgule |
custom_id | Mettre à 1 si les ids utilisés sont des ids personnalisés. (suppression dans tous les groupes) |
Résultats
Résultat | Description |
---|---|
{resultat: true, contacts: {id: {'resultat' => true}}} | resultat = true = Contact supprimé avec succès contacts = Informations pour chaque contact |
{resultat: false, contacts: {id: {'resultat' => false, 'erreurs' => {2}}}} | resultat = false = Erreur lors de la suppression du contact. contacts = Informations pour chaque contact erreurs = Tableau des erreurs rencontrées. |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id vide ou non existante |
2 | Le système a rencontré une erreur, merci de nous contacter |
8Colonnes
Liste des colonnes
URL à appeler : https://www.spot-hit.fr/api/columns
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat |
---|
[ [455]["Critère 1"][1] [575]["Critère 2"][2] ... ] |
Correspondance
Eléments | Description |
---|---|
[id] | Identifiant unique |
[nom] | Nom du critère |
[numero] | Numéro de classement des critères |
Ajouter un critère
URL à appeler : https://www.spot-hit.fr/api/column/add
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
nom | Nom du critère |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 45498} | resultat = 1 = Elément ajouté avec succès. id = Identifiant unique de l'élément |
{resultat: 0, erreurs: "1,2,3,4"} | resultat = 0 = Erreur lors de l'ajout. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Le nom est vide |
2 | Le nom contient plus de 11 caractères |
3 | Nombre de critères limité à 6 |
4 | Le système a rencontré une erreur, merci de nous contacter |
Modifier une colonne
URL à appeler : https://www.spot-hit.fr/api/column/edit
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
nom | Nom du critère |
id | Identifiant du critère à modifier |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément modifié avec succès |
{resultat: 0, erreurs: "1,2,3,4"} | resultat = 0 = Erreur lors de la modification. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Identifiant inexistant |
2 | Le nom est vide |
3 | Le nom contient plus de 11 caractères |
4 | Le système a rencontré une erreur, merci de nous contacter |
Supprimer une colonne
URL à appeler : https://www.spot-hit.fr/api/column/delete
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant de l'élement à supprimer |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément supprimé avec succès |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de la suppression. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Identifiant inexistant |
2 | Le système a rencontré une erreur, merci de nous contacter |
9Réponses
Liste des réponses
URL à appeler : https://www.spot-hit.fr/api/responses
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
date_debut | Optionnel, timestamp date de début de la sélection. (défaut : date création compte) |
date_fin | Optionnel, timestamp date de fin de la sélection. (défaut : maintenant) |
limit | Optionnel, nombre de résultats maximum dans la sélection. (max : 10 000) |
start | Optionnel, point de départ de la séléction. |
id | Optionnel, sélection unique du message correspondant à l'identifiant fourni. |
Résultats
Résultat |
---|
[ ['id']['numero']['message']['date_envoi']['source_id'] ... ] |
Correspondance
Eléments | Description |
---|---|
[id] | Identifiant unique |
[numero] | Numéro de téléphone de l'émetteur |
[message] | Contenu du message réponse |
[date_envoi] | Timestamp date d'envoi de la réponse |
[source_id] | Identifiant unique du message source |
Liste des STOP
URL à appeler : https://www.spot-hit.fr/api/stops
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat |
---|
[ ['id']['numero']['date_envoi']['source_id'] ... ] |
Correspondance
Eléments | Description |
---|---|
[id] | Identifiant unique |
[numero] | Numéro de téléphone de l'émetteur |
[date_envoi] | Timestamp date d'envoi de la réponse |
[source_id] | Identifiant unique du message source |
Ajouter des STOP
URL à appeler : https://www.spot-hit.fr/api/contacts/blacklist
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
numeros ou emails |
Tableau des numeros numeros[0]=+33600000001 numeros[1]=+33100000002 Tableau des emails emails[0][email protected] emails[1][email protected] |
Résultats
Résultat | Description |
---|---|
{resultat: X} | resultat = X = Nombre de numéros ajoutés |
{resultat: 0, erreurs: "30"} | resultat = 0 = Erreur lors de l'ajout erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
30 | Clé API non reconnue. |
100 | Ip non autorisée. |
Réception (PUSH) des réponses
URL à appeler : Vous devez paramétrer sur votre compte l'adresse que notre plate-forme appellera à chaque réception d'une réponse à l'un de vos messages. Accès rapide aux paramètres
Paramètres (GET)
Paramètre | Description |
---|---|
id | Identifiant unique |
numero | Numéro de téléphone de l'émetteur |
date | Timestamp date d'envoi de la réponse |
message | Contenu du message réponse |
source | Identifiant unique du message source |
Réception (PUSH) des STOP
URL à appeler : Vous devez paramétrer sur votre compte l'adresse que notre plate-forme appellera à chaque réception d'un STOP à l'un de vos messages. Accès rapide aux paramètres
PARAMETRES (GET)
Paramètre | Description |
---|---|
id | Identifiant unique |
numero | Numéro de téléphone de l'émetteur (peut-être vide si le champs email est renseigné) |
Email de l'émetteur (peut-être vide si le champs numero est renseigné) | |
date_envoi | Timestamp date d'envoi de la réponse |
source_id | Identifiant unique du message source |
10Groupes
Liste des groupes
URL à appeler : https://www.spot-hit.fr/api/groupe/lister
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat |
---|
[{"id":"1","commercant":"1","groupe":"Groupe 1","total":"10"},{"id":"2","commercant":"1","groupe":"Groupe 2","total":"25"}] |
Ajouter un groupe
URL à appeler : https://www.spot-hit.fr/api/groupe/creer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
nom | Nom du groupe (100 caractères max) |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 45498} | resultat = 1 = Elément ajouté avec succès. id = Identifiant unique de l'élément |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de l'ajout. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Impossible de créer le groupe / Vérifier que le groupe soit unique |
2 | Le nom est vide ou contient plus de 100 caractères |
Renommer un groupe
URL à appeler : https://www.spot-hit.fr/api/groupe/renommer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
nom | Nom du groupe (100 caractères max) |
id | Identifiant du groupe à modifier |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément modifié avec succès |
{resultat: 0, erreurs: "1,2,3"} | resultat = 0 = Erreur lors de la modification. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Impossible de renommer le groupe |
2 | Le nom est vide ou contient plus de 100 caractères |
3 | ID groupe non renseigné ou inexistant |
Supprimer un groupe
URL à appeler : https://www.spot-hit.fr/api/groupe/supprimer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant de l'élement à supprimer |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément supprimé avec succès |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de la suppression. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Erreur lors de la suppression du groupe |
2 | ID groupe non renseigné ou inexistant |
11Comptes
Consultation du solde
URL à appeler : https://www.spot-hit.fr/api/credits
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat | Description |
---|---|
{resultat: true, pre_paye: false, post_paye: false, euros: "0", premium: "1000", mms: "5", mobile: "50", fixe: "50", direct_classique: "50", direct_premium: "50", email: "100", fax: "100"} | Résultat de la requête + option pré-payée en euros + option post-payée + nombre de crédits restants (par type) sur votre compte (uniquement si l'option post-payée n'est pas activité). |
Consultation des statistiques par période
URL à appeler : https://www.spot-hit.fr/api/statistiques
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
date_debut | Optionnel, timestamp date de début de la sélection. (défaut : date du début du mois en cours) |
date_fin | Optionnel, timestamp date de fin de la sélection. (défaut : maintenant) |
sous_compte | Optionnel, booléen 1/0 pour prendre en compte la consommation des sous-comptes. (défaut : 0) |
Résultats
Résultat |
---|
{resultat: true, statistiques:{"premium":0, "direct_classique":0, "direct_premium":0, "mobile":0,"fixe":0, "html":0, "fax":0, "hlr":0, "mms":0, "courrier_gestion":{"affranchissement":0,"routage":0,"supplement":0},"pays":[]}} |
12Sous-comptes
Liste des sous-comptes
URL à appeler : https://www.spot-hit.fr/api/sous-compte/get
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat |
---|
[ {"id":"1","email":"[email protected]","civilite":"M","nom":"Nom 1","prenom":"Prenom 1","nom_entreprise":"Entreprise 1","nom_commercial":"Nom commercial 1","adresse":"rue du test","ville":"Roanne","code_postal":"42300","pays":"France M\u00e9tropolitaine","date_inscription":"1327843894","api_cle":"lacleapidusouscompte","solde_premium":"0","solde_email":"10","solde_fax":"10","solde_fixe":"10","solde_mobile":"10","solde_direct_repondeur":"10","actif":1} ... ] |
Ajouter un sous compte
URL à appeler : https://www.spot-hit.fr/api/sous-compte/add
Paramètres
Paramètre | Description |
---|---|
civilite | (M, Mme) |
nom | |
prenom | |
nom_entreprise | |
nom_commercial | |
raison | (entreprise, association, administration) |
adresse | |
code_postal | |
ville | |
telephone_personnel | |
telephone_entreprise | |
motdepasse | Votre mot de passe |
confirmation | Confirmation de votre mot de passe |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 400045, key: 3c6e0b8a9c15224a8228b9a98ca1531d} | resultat = 1 = Elément ajouté avec succès id = identifiant unique du compte key = clé api du compte |
{resultat: 0, erreur: "Votre erreur"} | resultat = 0 = Erreur lors de l'ajout. erreur = Votre erreur |
Modifier un sous compte
URL à appeler : https://www.spot-hit.fr/api/client/set
Paramètres
Paramètre | Description |
---|---|
client | L'Identifiant unique du sous-compte |
element | Elément que vous souhaitez modifier (nom, prenom, raison_sociale, nom_entreprise, nom_commercial, mot_de_passe, indicatif_defaut, email, identifiant_facture, code_comptable) |
valeur | La nouvelle valeur que vous souhaitez lui attribuer |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément modifié avec succès |
{resultat: 0, erreur: [1,2]} | resultat = 0 = Erreur lors de la modification. erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Elément non modifiable. |
2 | Valeur incorrecte/Email déjà utilisé. |
3 | Veuillez ne pas utiliser d'adresse email jetable. |
5 | Client introuvable/Pas la permission de modifier le client. |
6 | Le mot de passe doit contenir entre 8 et 50 caractères, au moins une majuscule, une minuscule, un chiffre et un caractère spécial. |
7 | Le mot de passe correspond à un ancien. |
8 | Une erreur est survenue. |
99 | Erreur SQL. |
Récupérer la liste des éléments du sous-compte
URL à appeler : https://www.spot-hit.fr/api/client/get
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | L'Identifiant unique du compte |
Résultats
Résultat | Description |
---|---|
{resultat: true, data: {"first_name": "John", "last_name": "Doe", ...}} | Tableau des données. |
{resultat: false, erreurs: [1, 2, 3]} | resultat = false = Erreur lors de la récupération des données. erreurs = Tableau des erreurs rencontrées. |
Correspondance
Eléments | Description |
---|---|
first_name | Prénom |
last_name | Nom |
civility | Civilité |
company_name | Nom entreprise |
commercial_name | Nom commercial |
address | Adresse |
zip_code | Code postal |
city | Ville |
country | Pays |
business_phone | Téléphone entreprise |
language | Langue |
api_key | Clé API |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Valeur d'identifiant incorrecte. |
2 | Valeur elément (elements) incorrecte. |
3 | Compte introuvable. |
Desactiver un sous compte
URL à appeler : https://www.spot-hit.fr/api/sous-compte/desactiver
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant unique du sous-compte |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément désactivé avec succès |
{resultat: 0, erreurs: [1,2]} | resultat = 0 = Erreur lors de la désactivation. erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id manquant. |
2 | Client introuvable/Pas la permission de modifier le client. |
Suspendre un sous compte
URL à appeler : https://www.spot-hit.fr/api/sous-compte/suspendu
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant unique du sous-compte |
etat | 0 : Lever la suspension 1 : Suspendre |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément suspendu avec succès |
{resultat: 0, erreurs: [1,2]} | resultat = 0 = Erreur lors de la suspension. erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id manquant. |
2 | Client introuvable/Pas la permission de modifier le client. |
Transférer des crédits
URL à appeler : https://www.spot-hit.fr/api/sous-compte/transferer-credits
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id_sous_compte | Identifiant du sous-compte |
act | Type d'action : "credit" ou "debit" |
type | Type de crédit : "premium", "direct_repondeur", "email", "mms", "fax" |
credits | Nombre de crédits à transférer |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément ajouté avec succès |
{resultat: 0, message: "message d'erreur"} | resultat = 0 = Erreur lors du transfert. message = Message de l'erreur rencontrée |
Paramétrer URL Push
URL à appeler : https://www.spot-hit.fr/api/urls/edit
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
accuses | URL de réception des accusés de réception |
stops | URL de réception des stops |
reponses | URL de réception des réponses |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément ajouté avec succès |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de la modification. erreurs = Liste des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Erreur interne. |
Détail des campagnes
URL à appeler : https://www.spot-hit.fr/api/client/details_campagnes
Paramètres
Paramètre | Description |
---|---|
format | json ou csv (par défaut json) |
debut | Timestamp unix début sélection (par défaut le 1er du mois dernier) |
fin | Timestamp unix fin sélection (par défaut le 31 du mois dernier) |
Modifier la facturation
URL à appeler : https://www.spot-hit.fr/api/billing/edit
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | ID du compte client |
facturation | (0 = Pre-payé, 1 = Post-payé) |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Elément ajouté avec succès |
{resultat: 0, erreurs: "1,2"} | resultat = 0 = Erreur lors de la modification. erreurs = Liste des erreurs rencontrées |
Ajouter un client (Marque-blanche)
URL à appeler : https://www.spot-hit.fr/api/client/creer
Attention, vous devez remplacer https://www.spot-hit.fr par le domaine de votre marque blanche.
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
raison | Raison sociale du compte : "entreprise", "association" ou "administration" |
nom_entreprise | Nom de l'entreprise du compte |
adresse | Adresse du compte |
code_postal | Code postal du compte |
ville | Ville du compte |
pays | Pays du compte |
civilite | Civilité du compte : "M" ou "Mme" |
nom | Nom du compte |
prenom | Prénom du compte |
Email du compte | |
telephone_entreprise | Téléphone pro du compte |
telephone_personnel | Téléphone perso du compte |
mdp_decrypte | Le mot de passe décrypté |
premium | Crédits SMS premium (défaut 0) |
credit_email | Crédits email (défaut 0) |
direct_classique | Crédits direct répondeur (défaut 0) |
fixe | Minutes fixe (défaut 0) |
mobile | Minutes mobile (défaut 0) |
fax | Crédits fax (défaut 0) |
valider_cgvu | Valider automatiquement les CGVU : 1 ou 0 |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 999} | resultat = 1 = Client ajouté avec succès + l'id du client |
{resultat: 0, erreur: "Erreur en texte"} | resultat = 0 = Erreur lors de la modification. erreur = L'erreur rencontrée |
Regénérer une clé api
URL à appeler : https://www.spot-hit.fr/api/sous-compte/regenerer-cle-api
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Id du sous compte à cibler |
Résultats
Résultat | Description |
---|---|
{resultat: true, cle_api: "2d1a18835cadd5944030bxx"} | resultat = true = Clé api regénérée avec succès cle_api = nouvelle clé api |
{resultat: false, erreurs: {1,2} | resultat = false = Erreur lors de la regénération de la clé api du sous compte. erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id vide ou sous compte inexistant |
2 | Le système a rencontré une erreur, merci de nous contacter |
Regénérer plusieurs clés api
URL à appeler : https://www.spot-hit.fr/api/sous-compte/regenerer-cle-apis
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
ids | Ids des sous compte à cibler sous forme de tableau ou séparés par une virgule |
Résultats
Résultat | Description |
---|---|
{resultat: true, sub_accounts: {id: {resultat: true, cle_api: "2d1a18835cadd5944030bxx"}}} | resultat = true = Clé api regénérée avec succès sub_accounts = tableau des sous comptes cle_api = nouvelle clé api |
{resultat: false, sub_accounts: {id: {resultat: false, erreurs: {1,2} }}} | resultat = false = Erreur lors de la regénération de la clé api du sous compte. sub_accounts = tableau des sous comptes erreurs = Tableau des erreurs rencontrées |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id vide ou sous compte inexistant |
2 | Le système a rencontré une erreur, merci de nous contacter |
Informations
URL à appeler : https://www.spot-hit.fr/api/sous-compte/informations
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Id du sous compte à cibler |
Résultats
Résultat | Description |
---|---|
{resultat: 1} | resultat = 1 = Tableau des données. |
{resultat: 0, erreurs: [1,2]} | resultat = 0 = Erreur lors de la récupération des données. erreurs = Tableau des erreurs rencontrées |
Correspondance
Eléments | Description |
---|---|
id | Id du compte ciblé |
last_name | Nom |
login | Login |
email_contact | Email de contact |
derniere_co | Dernière connexion |
compte_type | Type de compte |
dernier_achat | Dernier achat |
parent | Parent du sous-compte |
suspendu | Indique si le compte est suspendu |
credits | Liste des crédits |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Id manquant. |
2 | Client introuvable/Pas la permission de modifier le client. |
13Liens courts
Lister les liens courts
URL à appeler : https://www.spot-hit.fr/api/liens-courts/lister
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
Résultats
Résultat |
---|
[ {"id":"1", "nom":"Redirection1", "is_online":false, "domaine_id":null, "sous_domaine":null, "extension":null, "url":null, "adresse_cible":"http:\/\/mon-site.fr"}, {"id":"2", "nom":"Redirection2", "is_online":true, "domaine_id":"1", "sous_domaine":"www", "extension":"promo", "url":"www.mon-site.fr\/promo", "adresse_cible":"http:\/\/mon-site.fr"} ] |
Ajouter un lien court
URL à appeler : https://www.spot-hit.fr/api/liens-courts/creer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
adresse_cible | URL ciblée par le lien court |
extension | Extension du lien court |
nom | Optionnel, nom du lien court. (défaut : redirection) |
domaine_id | Optionnel, id du nom de domaine à utiliser. (défaut : sm-s.fr) |
sous_domaine | Optionnel, sous-domaine à utiliser. (défaut : aucun) |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 58489} | resultat = 1 = Elément ajouté avec succès id = identifiant du lien court |
{resultat: 0, erreurs: 1} | resultat = 0 = Erreur lors de l'ajout. erreurs = Code de l'erreur rencontrée |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Erreur interne. |
2 | Pas la permission d'utiliser le domaine. |
3 | Extension déjà utilisée. |
4 | Adresse cible non renseignée. |
5 | Extension non renseignée. |
6 | Domaine non trouvé. |
7 | Erreur interne au niveau des statistiques. |
Supprimer un lien court
URL à appeler : https://www.spot-hit.fr/api/liens-courts/supprimer
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant de l'élement à supprimer |
Résultats
Résultat | Description |
---|---|
{resultat: 1, id: 58489} | resultat = 1 = Elément supprimé avec succès id = identifiant du lien court |
{resultat: 0, erreurs: 1} | resultat = 0 = Erreur lors de la suppression. erreurs = Code de l'erreur rencontrée |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Erreur lors de la supprimer du lien court. |
2 | ID du lien court non renseigné ou inexistant. |
Statistiques d'un lien court
URL à appeler : https://www.spot-hit.fr/api/liens-courts/statistiques
Paramètres
Paramètre | Description |
---|---|
key | Votre clé API d'identification |
id | Identifiant de l'élement |
Résultats
Résultat | Description |
---|---|
{resultat: 1, statistiques: {...}, cliqueurs: {...}} | resultat = 1 = Elément supprimé avec succès statistiques = toutes les statistiques disponibles du lien court cliqueurs = tous les cliqueurs du lien court |
{resultat: 0, erreurs: 1} | resultat = 0 = Erreur lors de la récupération des statistiques. erreurs = Code de l'erreur rencontrée |
Tableau des erreurs
Numéro | Description |
---|---|
1 | Erreur interne. |
2 | ID du lien court non renseigné ou inexistant. |
14Annexes
Envoi d'un SMS par email
Fonctionnement
Vous devez envoyer les messages à l'adresse [email protected].
La syntaxe des paramètres est équivalente à celle de l'envoi de message par requête HTTP.
Rédaction de l'email :
- Sujet : apiKey=0000000000000&sender=Expediteur&truncate=0&smslong=1&phoneNumbers=+336xxxxxxxxx,+336xxxxxxxxx
Paramètre Description apiKey Votre clé API d'identification phoneNumbers Destinataire(s) du SMS. sender Optionnel
Si il est non renseigné, l'expéditeur de votre SMS sera le nom d'expéditeur de l'email
11 caractères maximum (espaces inclus)truncate Optionnel
Si égal à "1", tronque automatiquement le message à 160 caractères. Par défaut = 1smslong Optionnel
Si égal à "1", autorise l'envoi de SMS supérieur à 160 caractères. Par défaut = 0 - Contenu : Contenu du SMS.
Pour plus de souplesse, nous vous conseillons d'utiliser notre API HTTP.
Envoi d'un courrier par email
Envoi dématérialisé de vos courriers de gestions : factures, devis, relances, courrier de bienvenue...
Attention, cette méthode n'est pas utilisable pour vos courriers marketing en masse, vous devez utiliser l'interface en ligne.
Fonctionnement
Vous devez envoyer les messages à l'adresse [email protected]. Ceux-ci doivent être envoyés depuis l'adresse email enregistrée en tant qu'identifiant du compte (configuration spéciale possible, nous contacter).
- Impression d'un document (A4 80gr couleur), 2 plis et mise sous enveloppe à double fenêtre C6. (coût de 0.27€ HT, contactez-nous pour un volume supérieur à 1000 courriers par mois)
- Page(s) supplémentaire(s) : Un document peut comprendre jusqu'à 5 pages maximum par enveloppe (coût par page supplémentaire : 0.15€ HT, contactez-nous pour un volume supérieur à 1000 courriers par mois)
- Acheminement du courrier avec affranchissement Ecopli Grand Compte J+4 à 0.567€. (Affranchissement rapide (LG2, J+2) disponible sur demande avec un coût unitaire à 0.6€.)
- Dépôt en poste le jour même à 16h30 si réception des documents avant 15h00 (du lundi au vendredi).
- Produit disponible aujourd'hui uniquement pour les clients en facturation mensuelle (consommation visible en cliquant sur 'Afficher le détail' sur la page d'accueil de l’espace client)
Contraintes obligatoires sur la première page :
- Adresse du destinataire à placer sur la première page de manière standard (40mm du bord haut, 20mm du bord droit, taille max. de la zone adresse 100*45mm).
- Adresse de l'expéditeur à placer sur la première page de manière standard (20mm du bord haut, 10mm du bord gauche, taille max. de la zone adresse 90*35mm).
Rédaction de l'email :
- Expéditeur = Email de votre compte
- Destinataire = [email protected]
- Sujet = Champ libre non traité
- Pièce(s) jointe(s) = Un PDF par courrier à envoyer (max. 5 pages).
Envoi d'un fax par email
Fonctionnement
Vous devez envoyer les messages à l'adresse [email protected]. Ceux-ci doivent être envoyés depuis l'adresse email enregistrée en tant qu'identifiant du compte.
La syntaxe des paramètres est équivalente à celle de l'envoi de message par requête HTTP.
Rédaction de l'email :
- Sujet = Destinataire(s) du FAX.
- Pièce jointe = PDF du contenu du FAX (max. 10 pages).
- Nom de l'expéditeur = Expéditeur du FAX
Paramètres fixes à modifier avec votre gestionnaire de compte :
- Expéditeur (défaut = Nom de l'expéditeur du mail. Peut être fixé pour toujours être identique.)
Pour plus de souplesse, nous vous conseillons d'utiliser notre API HTTP.