Primeros pasos
TheCatAPI es una API REST de datos de razas, imágenes y análisis de fotos de gatos. Úsala para crear perfiles de mascotas, controles de salud y contenido por raza para dueños, o para añadir datos de razas a un producto de seguros, veterinaria o alimentación.
1. Consigue una clave de API
Regístrate y te enviaremos una clave por correo. Envíala en la cabecera x-api-key en cada petición. Autorización explica los detalles, y Cuentas de staging y producción explica cómo probar sin tocar datos reales.
2. Haz tu primera petición
curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/breeds/abys
{
"id": "abys",
"name": "Abyssinian",
…
}
Todos los endpoints están bajo https://api.thecatapi.com/v1. Si algo falla, Errores y límites explica cada código de estado y cuándo reintentar.
3. Elige qué estás construyendo
| Quieres… | Empieza por |
|---|---|
| Mostrar detalles de raza, datos curiosos y consejos de salud | Datos de razas para contenido |
| Buscar imágenes de gatos o dejar que los usuarios suban las suyas | Imágenes y Subida de imágenes |
| Dar a cada dueño un perfil para su mascota | Crear una mascota y luego Vincular mascotas a tus usuarios |
| Saber la raza, la edad o el peso a partir de fotos | Identificar la raza, Estimar la edad, Estimar el peso |
| Evaluar la condición corporal, con revisión veterinaria | Condición corporal |
| Recomendar calorías diarias o un plan para perder peso | Calorías diarias y Plan para perder peso |
| Llevar un historial de salud | Historial de salud de una mascota |
| Recibir resultados en tu servidor | Webhooks |
El resumen de guías las lista todas. La Referencia de la API lista cada endpoint y campo.
Planes
El plan Free sirve para aprender y para proyectos personales. El plan Startup añade una licencia comercial, límites de peticiones más altos y el conjunto completo de datos de razas por una cuota mensual baja. Los planes Enterprise desbloquean el análisis de fotos, los historiales de salud y las calculadoras.
Las características de raza (temperamento, origen, esperanza de vida, pelaje y puntuaciones de 1 a 5) y los datos curiosos vienen con Startup. Los consejos de salud, riesgos y recomendaciones dietéticas, alérgenos, pautas de aseo y ejercicio, chistes, análisis de fotos y retratos son Enterprise.
Para ver qué tiene activado tu clave, llama a GET /accounts/features o lee Elige qué está activado. Contáctanos sobre acceso y precios Enterprise.