Primeiros passos
TheDogAPI é uma API REST de dados de raças, imagens e análise de fotos de cães. 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.thedogapi.com/v1/breeds/115
{
"id": "115",
"name": "German Shepherd",
…
}
Todos os endpoints ficam em https://api.thedogapi.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 cães 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 (peso, altura, expectativa de vida), curiosidades e dicas de saúde vêm com o Startup. Estes conjuntos de dados podem ser adicionados a qualquer plano: riscos e recomendações alimentares, alérgenos, piadas, frequência cardíaca e respiratória por raça, parques para cães, genealogia, rotulagem de imagens e saúde dental.
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.