Primeiros passos

TheCatAPI é uma API REST de dados de raças, imagens e análise de fotos de gatos. Use-a para criar perfis de pets, checagens de saúde e conteúdo por raça para tutores, ou para adicionar dados de raças a um produto de seguros, veterinária ou alimentação.

1. Pegue uma chave de API

Cadastre-se e enviaremos uma chave por e-mail. Envie-a no cabeçalho x-api-key em toda requisição. Autorização traz os detalhes, e Contas de staging e produção explica como testar sem mexer em dados reais.

2. Faça sua primeira requisição

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/breeds/abys

{
  "id": "abys",
  "name": "Abyssinian",
  …
}

Todos os endpoints ficam em https://api.thecatapi.com/v1. Se algo der errado, Erros e limites explica cada código de status e quando tentar de novo.

3. Escolha o que você está construindo

Você quer…	Comece por
Mostrar detalhes da raça, curiosidades e dicas de saúde	Dados de raças para conteúdo
Buscar imagens de gatos ou deixar usuários enviarem as suas	Imagens e Envio de imagens
Dar a cada tutor um perfil para o seu pet	Criar um pet e depois Vincular pets aos seus usuários
Descobrir raça, idade ou peso a partir de fotos	Identificar a raça, Estimar a idade, Estimar o peso
Avaliar a condição corporal, com revisão veterinária	Condição corporal
Recomendar calorias diárias ou um plano de emagrecimento	Calorias diárias e Plano de emagrecimento
Manter um histórico de saúde	Histórico de saúde de um pet
Receber resultados no seu servidor	Webhooks

A visão geral dos guias lista todos eles. A Referência da API lista cada endpoint e campo.

Planos

O plano Free serve para aprender e para projetos pessoais. O plano Startup adiciona licença comercial, limites de requisições maiores e o conjunto completo de dados de raças por uma mensalidade baixa. Os planos Enterprise liberam a análise de fotos, os históricos de saúde e as calculadoras.

Características da raça (temperamento, origem, expectativa de vida, pelagem e notas de 1 a 5) e curiosidades vêm com o Startup. Dicas de saúde, riscos e recomendações alimentares, alérgenos, orientações de higiene e exercício, piadas, análise de fotos e retratos são Enterprise.

Para ver o que está ativo na sua chave, chame GET /accounts/features ou leia Escolha o que fica ativo. Fale conosco sobre acesso e preços Enterprise.