Liens

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

Point de terminaison de l'API:

GET 
https://goo.vc/api/v1/links?fr

Exemple de demande: 

curl --location --request GET 'https://goo.vc/api/v1/links?fr' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Paramètres
Type
Description
search
en option string
La requête de recherche.
search_by
en option string
Recherche par. Les valeurs possibles sont les suivantes : title pour Titre, alias pour Alias, url pour URL. La valeur par défaut est : title.
status
en option integer
Filtrer par statut. Les valeurs possibles sont les suivantes : 0 pour Tous, 1 pour Actif, 2 pour Expiré, 3 pour Handicapés. La valeur par défaut est : 0.
space_id
en option integer
Filtrer par ID d'espace.
domain_id
en option integer
Filtrer par ID de domaine.
pixel_id
en option integer
Filtre par ID de pixel.
sort_by
en option string
Trier par. Les valeurs possibles sont les suivantes : id pour Date de création, clicks pour Clics, title pour Titre, alias pour Alias, url pour URL. La valeur par défaut est : id.
sort
en option string
Trier. Les valeurs possibles sont les suivantes : desc pour Descente, asc pour Ascendante. La valeur par défaut est : desc.
per_page
en option integer
Résultats par page. Les valeurs possibles sont les suivantes : 10, 25, 50, 100. La valeur par défaut est : 10.
Afficher

Point de terminaison de l'API:

GET 
https://goo.vc/api/v1/links/{id}?fr

Exemple de demande: 

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

Point de terminaison de l'API:

POST 
https://goo.vc/api/v1/links?fr

Exemple de demande: 

curl --location --request POST 'https://goo.vc/api/v1/links?fr' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Paramètres
Type
Description
url
exigée string
Le lien doit être raccourci.
domain_id
exigée integer
L'ID du domaine sous lequel le lien doit être sauvegardé.
alias
en option string
L'alias du lien.
password
en option string
Le mot de passe du lien.
space_id
en option integer
L'identifiant de l'espace sous lequel le lien doit être sauvegardé.
pixel_ids
en option array
The pixel IDs to be integrated in the link.
disabled
en option integer
Indique si le lien est désactivé ou non. Les valeurs possibles sont les suivantes : 0 pour Actif, 1 pour Handicapés. La valeur par défaut est : 0.
privacy
en option integer
Que les statistiques sur les liens soient publiques ou non. Les valeurs possibles sont les suivantes : 0 pour Public, 1 pour Privé, 2 pour Mot de passe. La valeur par défaut est : 0.
privacy_password
en option string
Le mot de passe pour la page des statistiques. Ne fonctionne que si privacy est réglé sur 2.
expiration_url
en option string
Lien vers lequel l'utilisateur sera redirigé une fois que le lien aura expiré.
expiration_date
en option string
La date d'expiration du lien au format YYYY-MM-DD.
expiration_time
en option string
L'heure d'expiration du lien au format HH:MM.
expiration_clicks
en option integer
Nombre de clics après lequel le lien doit expirer.
target_type
en option integer
Le type de ciblage. Les valeurs possibles sont les suivantes : 0 pour Aucun, 1 pour Géographique, 2 pour Plate-forme, 4 pour Rotation.
country[index][key]
en option string
Le code du pays ciblé. Le code doit être conforme à la norme ISO 3166-1 alpha-2.
country[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
platform[index][key]
en option string
Le nom de la plate-forme ciblée. Les valeurs possibles sont les suivantes : iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
language[index][key]
en option string
Le code de la langue ciblée. Le code doit être conforme à la norme ISO 639-1 alpha-2.
language[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
rotation[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
Mise à jour

Point de terminaison de l'API:

PUT PATCH 
https://goo.vc/api/v1/links/{id}?fr

Exemple de demande: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?fr' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Paramètres
Type
Description
url
en option string
Le lien doit être raccourci.
alias
en option string
L'alias du lien.
password
en option string
Le mot de passe du lien.
space_id
en option integer
L'identifiant de l'espace sous lequel le lien doit être sauvegardé.
pixel_ids
en option array
The pixel IDs to be integrated in the link.
disabled
en option integer
Indique si le lien est désactivé ou non. Les valeurs possibles sont les suivantes : 0 pour Actif, 1 pour Handicapés.
privacy
en option integer
Que les statistiques sur les liens soient publiques ou non. Les valeurs possibles sont les suivantes : 0 pour Public, 1 pour Privé, 2 pour Mot de passe.
privacy_password
en option string
Le mot de passe pour la page des statistiques. Ne fonctionne que si privacy est réglé sur 2.
expiration_url
en option string
Lien vers lequel l'utilisateur sera redirigé une fois que le lien aura expiré.
expiration_date
en option string
La date d'expiration du lien au format YYYY-MM-DD.
expiration_time
en option string
L'heure d'expiration du lien au format HH:MM.
expiration_clicks
en option integer
Nombre de clics après lequel le lien doit expirer.
target_type
en option integer
Le type de ciblage. Les valeurs possibles sont les suivantes : 0 pour Aucun, 1 pour Géographique, 2 pour Plate-forme, 4 pour Rotation.
country[index][key]
en option string
Le code du pays ciblé. Le code doit être conforme à la norme ISO 3166-1 alpha-2.
country[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
platform[index][key]
en option string
Le nom de la plate-forme ciblée. Les valeurs possibles sont les suivantes : iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
language[index][key]
en option string
Le code de la langue ciblée. Le code doit être conforme à la norme ISO 639-1 alpha-2.
language[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
rotation[index][value]
en option string
Le lien vers lequel l'utilisateur sera redirigé.
Supprimer

Point de terminaison de l'API:

DELETE 
https://goo.vc/api/v1/links/{id}?fr

Exemple de demande: 

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