Enlaces

Notas
Nivel experto
La clave API debe enviarse como un token de portador en la cabecera de autorización de la solicitud. Obtenga su clave API.
Lista

Punto final de la API:

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

Ejemplo de solicitud: 

curl --location --request GET 'https://goo.vc/api/v1/links?es' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parámetro
Tipo
Descripción
search
opcional string
La consulta de búsqueda.
search_by
opcional string
Buscar por. Los valores posibles son: title para Título, alias para Alias, url para URL. Por defecto: title.
status
opcional integer
Filtrar por estado. Los valores posibles son: 0 para Todos, 1 para Activo, 2 para Caducado, 3 para Discapacitados. Por defecto: 0.
space_id
opcional integer
Filtrar por ID de espacio.
domain_id
opcional integer
Filtrar por ID de dominio.
pixel_id
opcional integer
Filtrar por ID de píxel.
sort_by
opcional string
Ordenar por. Los valores posibles son: id para Fecha de creación, clicks para Clics, title para Título, alias para Alias, url para URL. Por defecto: id.
sort
opcional string
Ordenar. Los valores posibles son: desc para Descendente, asc para Ascendente. Por defecto: desc.
per_page
opcional integer
Resultados por página. Los valores posibles son: 10, 25, 50, 100. Por defecto: 10.
Mostrar

Punto final de la API:

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

Ejemplo de solicitud: 

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

Punto final de la API:

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

Ejemplo de solicitud: 

curl --location --request POST 'https://goo.vc/api/v1/links?es' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'
Parámetro
Tipo
Descripción
url
requerido string
El enlace que hay que acortar.
domain_id
requerido integer
ID del dominio bajo el que se guardará el enlace.
alias
opcional string
El alias del enlace.
password
opcional string
La contraseña del enlace.
space_id
opcional integer
Espacio ID bajo el que se guardará el enlace.
pixel_ids
opcional array
The pixel IDs to be integrated in the link.
disabled
opcional integer
Si el enlace está desactivado o no. Los valores posibles son: 0 para Activo, 1 para Discapacitados. Por defecto: 0.
privacy
opcional integer
Si las estadísticas de enlaces son públicas o no. Los valores posibles son: 0 para Público, 1 para Privado, 2 para Contraseña. Por defecto: 0.
privacy_password
opcional string
La contraseña para la página de estadísticas. Sólo funciona con privacy ajustado a 2.
expiration_url
opcional string
El enlace al que se redirigirá al usuario una vez que el enlace haya caducado.
expiration_date
opcional string
La fecha de caducidad del enlace en formato YYYY-MM-DD.
expiration_time
opcional string
La hora de caducidad del enlace en formato HH:MM.
expiration_clicks
opcional integer
El número de clics tras los cuales debe caducar el enlace.
target_type
opcional integer
El tipo de orientación. Los valores posibles son: 0 para Ninguno, 1 para Geográfico, 2 para Plataforma, 4 para Rotación.
country[index][key]
opcional string
El código del país objetivo. El código debe estar en ISO 3166-1 alpha-2 estándar.
country[index][value]
opcional string
El enlace al que se redirigirá al usuario.
platform[index][key]
opcional string
El nombre de la plataforma objetivo. Los valores posibles son: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opcional string
El enlace al que se redirigirá al usuario.
language[index][key]
opcional string
El código de la lengua objetivo. El código debe estar en ISO 639-1 alpha-2 estándar.
language[index][value]
opcional string
El enlace al que se redirigirá al usuario.
rotation[index][value]
opcional string
El enlace al que se redirigirá al usuario.
Actualización

Punto final de la API:

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

Ejemplo de solicitud: 

curl --location --request PUT 'https://goo.vc/api/v1/links/{id}?es' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
Parámetro
Tipo
Descripción
url
opcional string
El enlace que hay que acortar.
alias
opcional string
El alias del enlace.
password
opcional string
La contraseña del enlace.
space_id
opcional integer
Espacio ID bajo el que se guardará el enlace.
pixel_ids
opcional array
The pixel IDs to be integrated in the link.
disabled
opcional integer
Si el enlace está desactivado o no. Los valores posibles son: 0 para Activo, 1 para Discapacitados.
privacy
opcional integer
Si las estadísticas de enlaces son públicas o no. Los valores posibles son: 0 para Público, 1 para Privado, 2 para Contraseña.
privacy_password
opcional string
La contraseña para la página de estadísticas. Sólo funciona con privacy ajustado a 2.
expiration_url
opcional string
El enlace al que se redirigirá al usuario una vez que el enlace haya caducado.
expiration_date
opcional string
La fecha de caducidad del enlace en formato YYYY-MM-DD.
expiration_time
opcional string
La hora de caducidad del enlace en formato HH:MM.
expiration_clicks
opcional integer
El número de clics tras los cuales debe caducar el enlace.
target_type
opcional integer
El tipo de orientación. Los valores posibles son: 0 para Ninguno, 1 para Geográfico, 2 para Plataforma, 4 para Rotación.
country[index][key]
opcional string
El código del país objetivo. El código debe estar en ISO 3166-1 alpha-2 estándar.
country[index][value]
opcional string
El enlace al que se redirigirá al usuario.
platform[index][key]
opcional string
El nombre de la plataforma objetivo. Los valores posibles son: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.
platform[index][value]
opcional string
El enlace al que se redirigirá al usuario.
language[index][key]
opcional string
El código de la lengua objetivo. El código debe estar en ISO 639-1 alpha-2 estándar.
language[index][value]
opcional string
El enlace al que se redirigirá al usuario.
rotation[index][value]
opcional string
El enlace al que se redirigirá al usuario.
Borrar

Punto final de la API:

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

Ejemplo de solicitud: 

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