# Liens 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


[
  {"id":"1", "nom":"Redirection1", "is_online":false, "domaine_id":null, "sous_domaine":null, "extension":null, "url":null, "link":"sms.link\/123456", "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", "link":"sms.link\/123456", "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
nom Optionnel
Nom du lien court. (défaut : redirection)
brand Optionnel
Mot-clé de votre choix. 25 caractères maximum (ex : sms.link/brand/123456)

# Résultats

Résultat Description
{resultat: 1, id: 58489, link: sms.link/123456} resultat = 1 = Elément ajouté avec succès
id = Identifiant du lien court
link = 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
8 Erreur au niveau du paramètre "brand" (nombre maximum de caractères atteint)
9 Pas accès a la fonctionnalité
10 Limite atteinte

# 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