acrt

API

Crea y consulta tus links, sus estadísticas y su QR desde tus propios programas. Todo responde JSON, menos el QR (SVG).

Primeros pasos

  1. Necesitas un plan que incluya acceso por API.
  2. Crea un token en /user/api-tokens y elige sus permisos. Se muestra una sola vez: guárdalo.
  3. Envíalo en cada petición con la cabecera Authorization.
curl https://acrt.jbflores.com.mx/api/v1/me \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Accept: application/json"

Permisos del token

Cada token tiene permisos: read (consultar), create (crear), update (editar) y delete (borrar). Una petición sin el permiso que necesita responde 403.

Endpoints

Dirección base: https://acrt.jbflores.com.mx/api/v1

Método Ruta Permiso
GET /me

Tu plan, tu límite y el token que usas. Sirve para comprobar que el token funciona.

read
GET /links

Lista tus links, del más nuevo al más viejo. Filtros: search, tag, per_page (1-100) y page.

read
POST /links

Crea un link. Campos: url (obligatorio) y alias (opcional; requiere un plan con alias).

create
POST /links/bulk

Crea varios links de una vez (función de carga masiva). Cuerpo: links, una lista de hasta 100 objetos con url, alias, title y tags. Responde un resultado por elemento.

create
GET /links/{slug}

Un link.

read
PATCH /links/{slug}

Edita un link. Campos (todos opcionales): title, url, tags, is_active, expires_at, max_clicks, password, clear_password. Cada uno exige la función de tu plan.

update
DELETE /links/{slug}

Borra el link y sus estadísticas. Responde 204 sin cuerpo.

delete
GET /links/{slug}/stats

Visitas de personas y de bots, países y, según tu plan, visitas por día, dispositivos, navegadores, sistemas, orígenes y ciudades. Lo que tu plan no incluye viene como null.

read
GET /links/{slug}/qr

El código QR en SVG o PNG (format=svg|png; size de 64 a 2000), con los colores, el estilo y el logo que tu plan permita.

read

Ejemplos

Crear un link

curl -X POST https://acrt.jbflores.com.mx/api/v1/links \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/una/direccion/larga", "alias": "promo"}'

Respuesta (201):

{
  "data": {
    "slug": "promo",
    "short_url": "https://acrt.jbflores.com.mx/promo",
    "qr_url": "https://acrt.jbflores.com.mx/api/v1/links/promo/qr",
    "url": "https://example.com/una/direccion/larga",
    "title": "example.com",
    "is_active": true,
    "expires_at": null,
    "max_clicks": null,
    "has_password": false,
    "tags": [],
    "visits": 0,
    "clicks": 0,
    "created_at": "2026-11-20T10:30:00-06:00",
    "updated_at": "2026-11-20T10:30:00-06:00"
  }
}

Editar un link

curl -X PATCH https://acrt.jbflores.com.mx/api/v1/links/promo \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"is_active": false, "tags": ["verano"], "expires_at": "2026-12-31T23:59:00-06:00"}'

Ver estadísticas

curl https://acrt.jbflores.com.mx/api/v1/links/promo/stats -H "Authorization: Bearer TU_TOKEN"

Errores

Los errores son JSON con un campo message. Algunos traen además un code que puedes leer desde tu programa.

401 Falta el token o no es válido.
403 El token no tiene el permiso, o tu plan no incluye la función (code: feature_not_available) o ya usaste todos tus links (code: link_limit_reached).
404 El link no existe o no es tuyo.
422 Datos no válidos: el cuerpo trae errors con el detalle de cada campo.
429 Demasiadas peticiones (code: rate_limited). Revisa la cabecera Retry-After.

Límites

Hasta 120 peticiones por minuto por token. Las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining te dicen cuántas quedan.