Liens

Notes
Niveau expert
La clé API doit être envoyée sous forme de jeton Bearer dans l'en-tête Authorization de la requête. Obtenez votre clé API.
Liste

Point d'accès API:

GET 
https://tuz.fr/api/v1/links

Exemple de requête: 

curl --location --request GET 'https://tuz.fr/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Paramètre
Type
Description
search
facultatif string
La requête de recherche.
search_by
facultatif string
Rechercher par. Les valeurs possibles sont : title pour Titre, alias pour Alias, url pour URL. Par défaut : title.
status
facultatif integer
Filtrer par statut. Les valeurs possibles sont : 0 pour Tout, 1 pour Actif, 2 pour Expiré, 3 pour Désactivé. Par défaut : 0.
space_id
facultatif integer
Filtrer par ID d'espace.
domain_id
facultatif integer
Filtrer par ID de domaine.
pixel_id
facultatif integer
Filtrer par ID de pixel.
sort_by
facultatif string
Trier par. Les valeurs possibles sont : id pour Date de création, clicks pour Clics, title pour Titre, alias pour Alias, url pour URL. Par défaut : id.
sort
facultatif string
Trier. Les valeurs possibles sont : desc pour Descendant, asc pour Ascendant. Par défaut : desc.
per_page
facultatif int
Résultats par page. Les valeurs possibles sont : 10, 25, 50, 100. Par défaut : 50.
Afficher

Point d'accès API:

GET 
https://tuz.fr/api/v1/links/{id}

Exemple de requête: 

curl --location --request GET 'https://tuz.fr/api/v1/links/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Magasin

Point d'accès API:

POST 
https://tuz.fr/api/v1/links

Exemple de requête: 

curl --location --request POST 'https://tuz.fr/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Paramètre
Type
Description
url
requis string
Le lien à raccourcir.
domain_id
requis integer
L'ID du domaine sous lequel enregistrer le lien.
alias
facultatif string
L'alias du lien.
password
facultatif string
Le mot de passe du lien.
space_id
facultatif integer
L'ID de l'espace sous lequel enregistrer le lien.
pixel_ids
facultatif array
The pixel IDs to be integrated in the link.
disabled
facultatif integer
Que le lien soit désactivé ou non. Les valeurs possibles sont : 0 pour Actif, 1 pour Désactivé. Par défaut : 0.
privacy
facultatif integer
Que les statistiques du lien soient publiques ou non. Les valeurs possibles sont : 0 pour Public, 1 pour Privé, 2 pour Mot de passe. Par défaut : 0.
privacy_password
facultatif string
Le mot de passe de la page de statistiques. Fonctionne uniquement avec privacy défini sur 2.
expiration_url
facultatif string
Le lien vers lequel l'utilisateur sera redirigé une fois que le lien aura expiré.
expiration_date
facultatif string
La date d'expiration du lien au format YYYY-MM-DD.
expiration_time
facultatif string
L'heure d'expiration du lien au format HH:MM.
expiration_clicks
facultatif integer
Le nombre de clics après lesquels le lien doit expirer.
target_type
facultatif integer
Le type de ciblage. Les valeurs possibles sont : 0 pour Aucun, 1 pour Géographique, 2 pour Plateforme, 4 pour Rotation.
country[index][key]
facultatif string
Le code du pays ciblé. Le code doit être dans le standard ISO 3166-1 alpha-2.
country[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
platform[index][key]
facultatif string
Le nom de la plateforme ciblée. Les valeurs possibles sont : iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
language[index][key]
facultatif string
Le code de la langue ciblée. Le code doit être dans le standard ISO 639-1 alpha-2.
language[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
rotation[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
Mettre à jour

Point d'accès API:

PUT PATCH 
https://tuz.fr/api/v1/links/{id}

Exemple de requête: 

curl --location --request PUT 'https://tuz.fr/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Paramètre
Type
Description
url
facultatif string
Le lien à raccourcir.
alias
facultatif string
L'alias du lien.
password
facultatif string
Le mot de passe du lien.
space_id
facultatif integer
L'ID de l'espace sous lequel enregistrer le lien.
pixel_ids
facultatif array
The pixel IDs to be integrated in the link.
disabled
facultatif integer
Que le lien soit désactivé ou non. Les valeurs possibles sont : 0 pour Actif, 1 pour Désactivé.
privacy
facultatif integer
Que les statistiques du lien soient publiques ou non. Les valeurs possibles sont : 0 pour Public, 1 pour Privé, 2 pour Mot de passe.
privacy_password
facultatif string
Le mot de passe de la page de statistiques. Fonctionne uniquement avec privacy défini sur 2.
expiration_url
facultatif string
Le lien vers lequel l'utilisateur sera redirigé une fois que le lien aura expiré.
expiration_date
facultatif string
La date d'expiration du lien au format YYYY-MM-DD.
expiration_time
facultatif string
L'heure d'expiration du lien au format HH:MM.
expiration_clicks
facultatif integer
Le nombre de clics après lesquels le lien doit expirer.
target_type
facultatif integer
Le type de ciblage. Les valeurs possibles sont : 0 pour Aucun, 1 pour Géographique, 2 pour Plateforme, 4 pour Rotation.
country[index][key]
facultatif string
Le code du pays ciblé. Le code doit être dans le standard ISO 3166-1 alpha-2.
country[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
platform[index][key]
facultatif string
Le nom de la plateforme ciblée. Les valeurs possibles sont : iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
language[index][key]
facultatif string
Le code de la langue ciblée. Le code doit être dans le standard ISO 639-1 alpha-2.
language[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
rotation[index][value]
facultatif string
Le lien vers lequel l'utilisateur sera redirigé.
Supprimer

Point d'accès API:

DELETE 
https://tuz.fr/api/v1/links/{id}

Exemple de requête: 

curl --location --request DELETE 'https://tuz.fr/api/v1/links/{id}' \
--header 'Authorization: Bearer {api_key}'