Enlaces

Autenticación

La clave API debe enviarse como token Bearer en el encabezado de autorización de la solicitud. Obtén tu clave API.

Lista

Endpoint de API

GET

https://urli.click/api/v1/links

Ejemplo de solicitud

curl --location --request GET 'https://urli.click/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'

Parameters

Nombre

Tipo

Descripción

search

opcional string

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

Estado. Los valores posibles son: 0 para Todos, 1 para Activo, 2 para Expirado, 3 para Deshabilitado. Por defecto: 0.

space_id

opcional integer

ID del espacio.

domain_id

opcional integer

ID del dominio.

pixel_id

opcional integer

ID del 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

Endpoint de API

GET

https://urli.click/api/v1/links/{id}

Ejemplo de solicitud

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

Almacenar

Endpoint de API

POST

https://urli.click/api/v1/links

Ejemplo de solicitud

curl --location --request POST 'https://urli.click/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}' \
--data-urlencode 'domain={id}'

Parameters

Nombre

Tipo

Descripción

url

requerido string

URL de destino.

domain_id

requerido integer

ID del dominio.

alias

opcional string

Alias.

space_id

opcional integer

ID del espacio.

pixel_ids[]

opcional array

IDs de píxeles.

redirect_password

opcional string

Contraseña de redirección.

sensitive_content

opcional integer

Contenido sensible. Los valores posibles son: 0 para No, 1 para Sí. Por defecto: 0.

privacy

opcional integer

Privacidad de estadísticas. Los valores posibles son: 0 para Público, 1 para Privado, 2 para Contraseña. Por defecto: 0.

password

opcional string

Contraseña de estadísticas. Solo funciona con el campo privacy establecido en 2.

active_period_start_at

opcional string

Fecha de inicio del período activo en formato Y-m-dTH:i:s.

active_period_end_at

opcional string

Fecha de finalización del período activo en formato Y-m-dTH:i:s.

clicks_limit

opcional integer

Límite de clics.

expiration_url

opcional string

URL de expiración.

targets_type

opcional string

Segmentación. Los valores posibles son: continents para Continents, countries para Countries, operating_systems para Operating systems, browsers para Browsers, languages para Languages, devices para Devices, rotations para Rotations.

targets[index][key]

opcional string

Para targets_type=country, el valor debe estar en formato ISO 3166-1 alpha-2.

Para targets_type=operating_systems, los valores posibles son: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.

Para targets_type=browsers, los valores posibles son: Chrome, Chromium, Firefox, Firefox Mobile, Edge, Internet Explorer, Mobile Internet Explorer, Vivaldi, Brave, Safari, Opera, Opera Mini, Opera Mobile, Opera Touch, Yandex Browser, UC Browser, Samsung Internet, QQ Browser, BlackBerry Browser, Maxtho.

Para targets_type=devices, los valores posibles son: Desktop, Mobile, Tablet, Watch, Television.

Para targets_type=languages, el valor debe estar en formato ISO 639-1 alpha-2.

Para targets_type=continents, los valores posibles son: AF para Africa, AN para Antarctica, AS para Asia, EU para Europe, NA para North America, OC para Oceania, SA para South America.

targets[index][value]

opcional string

URL de destino.

Actualizar

Endpoint de API

PUT PATCH

https://urli.click/api/v1/links/{id}

Ejemplo de solicitud

curl --location --request PUT 'https://urli.click/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}'

Parameters

Nombre

Tipo

Descripción

url

opcional string

URL de destino.

alias

opcional string

Alias.

space_id

opcional integer

ID del espacio.

pixel_ids[]

opcional array

IDs de píxeles.

redirect_password

opcional string

Contraseña de redirección.

sensitive_content

opcional integer

Contenido sensible. Los valores posibles son: 0 para No, 1 para Sí.

privacy

opcional integer

Privacidad de estadísticas. Los valores posibles son: 0 para Público, 1 para Privado, 2 para Contraseña.

password

opcional string

Contraseña de estadísticas. Solo funciona con el campo privacy establecido en 2.

active_period_start_at

opcional string

Fecha de inicio del período activo en formato Y-m-dTH:i:s.

active_period_end_at

opcional string

Fecha de finalización del período activo en formato Y-m-dTH:i:s.

clicks_limit

opcional integer

Límite de clics.

expiration_url

opcional string

URL de expiración.

targets_type

opcional string

targets[index][key]

opcional string

Para targets_type=country, el valor debe estar en formato ISO 3166-1 alpha-2.

Para targets_type=operating_systems, los valores posibles son: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.

Para targets_type=devices, los valores posibles son: Desktop, Mobile, Tablet, Watch, Television.

Para targets_type=languages, el valor debe estar en formato ISO 639-1 alpha-2.

targets[index][value]

opcional string

URL de destino.

Eliminar

Endpoint de API

DELETE

https://urli.click/api/v1/links/{id}

Ejemplo de solicitud

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