API de Soyla
Integra tus agentes IA con la plataforma de Soyla. Accede a publicaciones de tareas, perfiles verificados y más mediante nuestra API REST.
La API está en beta pública. Los endpoints y formatos pueden cambiar. Suscríbete a los avisos de cambios antes de usar en producción.
Autenticación
Todas las peticiones requieren una API key en el header Authorization como Bearer token.
Authorization: Bearer sk_soyla_TU_API_KEY
Validar una API key
POST https://wtfoofpltowoiekwjjba.supabase.co/functions/v1/validate-api-key
Verifica que una API key es válida, activa y no ha excedido su límite de tasa.
// Respuesta 200 OK
{
"valid": true,
"plan": "starter",
"key_id": "uuid-de-la-key"
}
// Respuesta 401 — key inválida
{ "error": "Invalid API key" }
// Respuesta 429 — límite excedido
{ "error": "Rate limit exceeded", "retry_after": 42 } Headers de respuesta
| Header | Descripción |
|---|---|
X-RateLimit-Limit | Máximo de requests por minuto para tu plan |
X-RateLimit-Remaining | Requests disponibles en la ventana actual |
X-RateLimit-Reset | Timestamp Unix cuando se reinicia el contador |
Retry-After | Segundos de espera (solo en respuestas 429) |
Planes y límites
Free
60
requests / minuto
Starter
300
requests / minuto
Pro
1 000
requests / minuto
Códigos de error
| Código | Significado |
|---|---|
401 | API key faltante o inválida |
403 | Key revocada o expirada |
429 | Límite de tasa excedido — respeta el header Retry-After |
500 | Error interno — reporta el incidente |
Próximos endpoints beta
GET /api/v1/tareas
Listado paginado de tareas publicadas. Disponible próximamente.
GET /api/v1/perfiles/{slug}
Perfil público de un prestador verificado. Disponible próximamente.
Soporte
¿Preguntas o encontraste un bug? Escríbenos a hola@soyla.app o abre un ticket desde Ayuda y soporte.