API de Acortamiento de Enlaces de Linkly

Crea, actualiza y gestiona enlaces mediante programación utilizando la API de Acortamiento de Enlaces de Linkly.

Relacionado: API de Análisis | Webhooks

Antes de Comenzar

Linkly genera solicitudes API en la interfaz para que las copies y pegues en tus aplicaciones.

Esto funciona para la creación de enlaces y la actualización de enlaces.

Ahorra tiempo y deja que hagamos el trabajo difícil:

1. 1
   Consulta a continuación las solicitudes API de creación de enlaces.
2. 2
   Copia las solicitudes en su totalidad. Puedes verificar que funcionan para ti.
3. 3
   Pide a ChatGPT o equivalente que adapte estas solicitudes en código fuente para tu aplicación. No hay necesidad de invertir tiempo en una integración compleja. Nuestra API es completamente consumible por máquinas.

---

Especificación OpenAPI 3.0

Puedes generar solicitudes API directamente desde la interfaz de usuario de Linkly.

La API de Linkly está documentada utilizando el estándar OpenAPI, que va más allá de lo proporcionado a continuación. Los mismos puntos finales también están disponibles como una colección de Postman de un clic.

Ver Especificación OpenAPI

Ejecutar en Postman

Autorización

Necesitarás:

• Tu Clave API
• ID del Espacio de Trabajo

Puedes obtener estos detalles dentro de Linkly.

1. 1
   Inicia sesión en Linkly.
2. 2
   Haz clic en Configuración.
3. 3
   Haz clic en Claves API.

Crear o actualizar un enlace

Para crear un enlace, todo lo que necesitas hacer es enviar una solicitud POST a:

https://app.linklyhq.com/api/v1/link

con los siguientes campos en el cuerpo.

El tipo de codificación es x-www-form-urlencoded o application/json.

Si envías el campo Rules, debes usar application/json.

Te recomendamos que uses JSON con la especificación Open API.

Ejemplo de Solicitud usando cURL

El código a continuación ilustra cómo hacer una solicitud API para crear un enlace.

curl -X POST https://app.linklyhq.com/api/v1/link
-H 'cache-control: no-cache'
-d 'api_key=your_secret_key&workspace_id=1&url=http%3A%2F%2Fwww.wikijob.co.uk&name=Test%20Link'

Una respuesta exitosa devolverá un objeto JSON que representa el enlace, junto con un id de enlace.

{
    "id": 9512,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "replacements": null,
    "enabled": true,
    "cloaking": false,
    "forward_params": false,
    "hide_referrer": false,
    "block_bots": false,
    "skip_social_crawler_tracking": false,
    "public_analytics": false,
    "password": null,
    "domain": null,
    "slug": null,
    "utm_source": null,
    "utm_medium": null,
    "utm_campaign": null,
    "utm_term": null,
    "utm_content": null,
    "og_title": null,
    "og_description": null,
    "og_image": null,
    "fb_pixel_id": null,
    "tiktok_pixel_id": null,
    "ga4_tag_id": null,
    "gtm_id": null,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "rules": [],
    "expiry_datetime": null,
    "expiry_destination": null,
    "expiry_clicks": null,
    "qr_styles": null,
    "webhooks": [],
    "notify_user_ids": [],
    "workspace_id": 1448,
    "deleted": false
}

Actualizar un enlace

Para actualizar un enlace, envía la misma solicitud que usarías para crear el enlace, pero incluye el campo id para el enlace que deseas actualizar, así como los cambios.

Crear Rotadores a través de API

Para crear un rotador, envía un campo llamado rules como un array JSON, junto con la carga útil de enlace anterior. Debes usar application/json para enviar arrays JSON.

Por ejemplo:

[
  {"what": "rotator", "url": "https://www.microsoft.com", "percentage": "50"},
  {"what": "rotator", "url": "https://www.apple.com", "percentage": "50"}
]

Crear Redirecciones Geográficas a través de API

Para redirigir por país, envía un campo llamado rules como un array JSON, junto con la carga útil de enlace anterior. Debes usar codificación application/json para enviar arrays JSON.

Por ejemplo:

[
  {"what": "country", "url": "https://www.microsoft.com", "matches": "UK"},
  {"what": "country", "url": "https://www.apple.com", "matches": "US"}
]

El país es el código de país ISO 3166 de dos letras.

Crear Redirecciones de Dispositivo a través de API

Para redirigir por dispositivo, envía un campo llamado rules como un array JSON, junto con la carga útil de enlace anterior.

Por ejemplo:

[
  {"what": "platform", "url": "https://www.google.com", "matches": "windows"},
  {"what": "platform", "url": "https://www.apple.com", "matches": "ios"}
]

Donde el campo matches es uno de:

• ios
• android
• windows
• linux
• mac

Crear o Actualizar Múltiples Enlaces en una Solicitud

Linkly admite la creación/enmienda de hasta 1000 enlaces por solicitud.

Para hacerlo, envía tu clave API como parte de la solicitud de la siguiente manera:

https://app.linklyhq.com/api/v1/link?api_key=XXXXXXXXXXX

Luego, usa el mismo esquema que arriba para los casos de enlaces individuales, pero envuelve las solicitudes de enlace en un array, de la forma:

[{link}, {link}]

Aquí hay una solicitud completa que actualizará dos enlaces:

wget --no-check-certificate \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --body-data '[
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://nature.com",
        "name": "Test",
        "id": LINK_ID
    },
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://science.com",
        "id": LINK_ID
    }
]' \
   'https://app.linklyhq.com/api/v1/workspace/WORKSPACE_ID/links?api_key=API_KEY'

Esto funciona tanto para acciones de creación como de actualización.

Ten en cuenta que puede tomar hasta 60 segundos para una solicitud grande. Si las solicitudes tardan más que esto, fallarán, y deberías considerar dividir tu carga de trabajo en fragmentos más pequeños.

Límites de Velocidad

La API de acortamiento de enlaces está limitada a 20 solicitudes/segundo. Hay hasta 200 solicitudes por segundo disponibles bajo solicitud. Puedes cargar hasta 1000 enlaces en una sola solicitud.

Relacionado

• API de Análisis - Exporta datos de clics e informes de tráfico
• Webhooks - Notificaciones de clic en tiempo real
• Integración con Zapier - Integraciones sin código