API de ConvoChat
Una API REST simple para gestionar tus enlaces y leer estadísticas desde tu propio código.
Autenticación
Crea una API key desde tu cuenta en /app → API, elige sus scopes, y envíala en cada petición como cabecera Authorization: Bearer <token>. Todas las respuestas son JSON.
curl -s https://convo.chat/api/v1/links \
-H "Authorization: Bearer TU_API_KEY" \
-H "Accept: application/json"Scopes
Cada API key concede solo los scopes que elijas.
| links:read | Leer enlaces cortos. |
| links:write | Crear, editar y eliminar enlaces. |
| qr:read | Leer códigos QR. |
| qr:write | Crear y editar códigos QR. |
| bio:read | Leer páginas bio. |
| stats:read | Leer estadísticas de enlaces. |
Endpoints
Base: https://convo.chat/api/v1
GET
/links
Lista tus enlaces cortos (paginado).
links:read
POST
/links
Crea un enlace corto.
links:write
GET
/links/{id}
Obtiene un enlace por su public_id.
links:read
PATCH
/links/{id}
Actualiza un enlace.
links:write
DELETE
/links/{id}
Elimina un enlace.
links:write
GET
/links/{id}/stats
Estadísticas de un enlace.
stats:read
Límites y errores
- · Rate limit: por minuto según tu plan (cabeceras
X-RateLimit-*); al excederlo,429. - ·
401sin token o token inválido ·403scope insuficiente ·404recurso no tuyo o inexistente ·422validación.
Empieza a construir
Crea tu cuenta, genera una API key y haz tu primera petición en minutos.
Crear cuenta gratis