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
- Necesitas un plan que incluya acceso por API.
- Crea un token en /user/api-tokens y elige sus permisos. Se muestra una sola vez: guárdalo.
- 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.