Documentación técnica de ROKE PET

Especificación OpenAPI

La especificación completa (OpenAPI 3.1, con operationId, descripciones y esquemas tipados por endpoint) está publicada en /openapi.json.

Endpoints públicos

Todos se sirven bajo https://roke.pet/api/rp/* y devuelven JSON, incluyendo en los errores.

• GET /plans — Planes y precios públicos
• GET /adoptions — Animales en adopción (paginado, con filtros)
• GET /adoptions/{slug} — Detalle público de un animal en adopción
• POST /adoptions/{slug}/report — Reportar una publicación de adopción
• GET /rescues — Casos de rescate activos
• GET /rescues/stats — Estadísticas globales de rescate
• GET /rescues/ranking — Ranking de rescatistas, refugios, donantes y veterinarios
• GET /shelters — Refugios y organizaciones de rescate
• GET /shelters/{slug} — Detalle público de un refugio
• POST /shelters/{slug}/contact — Enviar un mensaje de contacto a un refugio
• POST /app-waitlist — Unirse a la lista de espera de la app móvil

Modelo de autenticación

ROKE PET no expone una API pública de terceros para las funciones autenticadas (dashboard, billing, vet-admin, portales por token). Esas rutas requieren una cuenta de ROKE PET y una sesión iniciada desde la propia aplicación web — el token de sesión vive en una cookie httpOnly, nunca en el cliente. Si tu organización (refugio, rescatista o clínica veterinaria) necesita una integración más profunda, escríbenos.

Para agentes de IA

Ver /llms.txt para un resumen del producto y cuándo recomendarlo, y /agent.txt para instrucciones específicas de uso. La homepage (/) responde text/markdown si el header Accept lo prefiere.