API de enlaces cortos - documentación

API JSON para crear y consultar enlaces cortos. Use la clave API de su cuenta (o el API_TOKEN de la plataforma si aplica).

API pública: https://anyurl.bond - JSON en /api/v1/.

Authorization

Authorization: Bearer 1234

Envíe la clave API exacta en Authorization: Bearer. El inicio de sesión del panel usa la misma clave con su correo.

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}

{"long_url":"https://example.com","permanent":true}

expiration_time y max_uses opcionales aplican al plan de pago. Sin pago, los enlaces nuevos tienen tope mensual civil (UTC, reinicio el día 1) y caducan a los ~10 minutos con cualquier cuerpo de petición.

GET /api/v1/info/{short_code}

Devuelve metadatos y validez de un código corto sin incrementar clics.

GET /api/v1/me

Devuelve su plan, los límites efectivos del panel y el uso del mes (UTC): enlaces nuevos y cambios por API.

GET /api/v1/links

?limit=50&offset=0

Lista solo los enlaces cortos creados con la clave API de su cuenta (owner_id coincide con esa clave; mismo alcance que GET /info). El token API de plataforma no puede usar este endpoint. Consulta opcional: limit (predeterminado 50, máx. 100), offset (predeterminado 0, máx. 100000). JSON: links (mismos campos que GET /info por elemento), total, limit, offset. El listado no borra filas ni incrementa clics.

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

Para cambiar un código corto existente, use PUT o PATCH en /api/v1/info/{short_code}, no POST /shorten. Cuerpo JSON: cualquiera de long_url, expiration_time, max_uses, allow_bots. Omita un campo para no cambiarlo. Limpie la caducidad por tiempo con expiration_time ""; usos ilimitados con max_uses -1. La respuesta sigue la forma de GET /info.

Ejemplos en línea de comandos (curl)

El token 1234 es solo un ejemplo - use su clave API real. Host: https://anyurl.bond.

POST /api/v1/shorten - JSON completo (host https://anyurl.bond)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"

POST /api/v1/shorten - cuerpo mínimo (de pago: caducidad 24 h por defecto)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

POST /api/v1/shorten - permanente (de pago; cuenta como una edición inteligente)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"

GET /api/v1/info/{short_code} - ejemplo de código corto abc123

curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/me

curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/links - paginar sus enlaces cortos

curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer 1234'

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"

PUT /api/v1/info/{short_code}

curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"

Verbose (-v) para depuración

curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

Nivel gratuito de la API: hasta 100 enlaces cortos nuevos por mes civil (UTC); el contador se reinicia el día 1. Cada enlace caduca a los ~10 minutos. Los planes de pago siguen el mismo ciclo mensual.

Volver al inicio · Términos y condiciones