Descripcion general
La API de BeePass ofrece acceso programatico a sus datos de cria: reinas, evaluaciones, valores geneticos estimados (EBV), pedigries y exportaciones. Todas las operaciones disponibles en la interfaz web son accesibles a traves de la API REST.
URL base
https://beepass.io/api/
Todas las rutas son relativas a esta base. Por ejemplo, la lista de reinas F0 es accesible a traves de GET https://beepass.io/api/queens/f0.
Autenticacion
Todas las rutas requieren una sesion autenticada a traves de Supabase Auth (cookies SSR). Las rutas de administracion requieren adicionalmente una cookie HMAC beepass-admin-token.
Consulte la pagina Autenticacion para obtener todos los detalles.
Formato
- Solicitudes:
Content-Type: application/json - Respuestas: JSON
- Codificacion: UTF-8
Paginacion
Los endpoints de listado admiten paginacion mediante parametros de consulta:
| Parametro | Tipo | Valor por defecto | Descripcion |
|---|---|---|---|
limit | entero | 20 | Numero de elementos por pagina (maximo 100) |
offset | entero | 0 | Numero de elementos a omitir |
Codigos de error
| Codigo | Descripcion |
|---|---|
400 | Solicitud incorrecta — parametros invalidos o cuerpo de solicitud malformado |
401 | No autorizado — sesion ausente o expirada |
403 | Prohibido — permisos insuficientes (por ejemplo, se requiere acceso de administrador) |
404 | No encontrado — el recurso no existe o no le pertenece |
429 | Demasiadas solicitudes — limite de tasa excedido |
500 | Error interno del servidor — error del lado del servidor |
Los errores devuelven un objeto JSON:
{
"error": "Descripcion del problema"
}
Limitacion de tasa
Los limites de solicitudes se aplican mediante Upstash Redis:
| Accion | Limite |
|---|---|
| Inicio de sesion | 10 intentos / 15 minutos |
| Registro | 3 / hora |
| Envio de codigo de verificacion | 5 / 10 minutos |
| Verificacion de codigo | 10 / minuto |
RLS (Row Level Security)
Todos los datos estan limitados al usuario autenticado a traves de owner_id = auth.uid(). Solo puede acceder a sus propias reinas, evaluaciones y resultados. Los datos de referencia (BeePass Index) son de solo lectura para todos los usuarios autenticados.
Vea tambien: Autenticacion | Claves API | Reinas | Evaluaciones | EBV | Exportacion