Integração aberta

LoveCats API

API pública e gratuita para integração com sistemas de adoção de gatinhos. Conecte seu site, app ou sistema de gestão à nossa plataforma.

✓ REST / JSON ✓ Gratuita para ONGs ✓ Autenticação API Key ✓ Docs completa

Recursos da API

API RESTful

Interface REST padronizada com respostas JSON.

Segurança

Autenticação via API Key e validação de dados.

Alta Performance

Resposta rápida e cache inteligente.

Dados Confiáveis

Informações validadas e atualizadas em tempo real.

Fácil Integração

Documentação completa e exemplos práticos.

Open Source

Gratuita para ONGs e projetos sociais.

Endpoints Disponíveis

Todos os endpoints retornam dados em formato JSON.

GET /api/cats

Lista todos os gatinhos disponíveis para adoção.

Parâmetros

color( string )opcionalFiltrar por cor

sex( string )opcionalFiltrar por sexo

age( string )opcionalFiltrar por idade

vaccinated( boolean )opcionalFiltrar por vacinação

neutered( boolean )opcionalFiltrar por castração

Resposta

{ "id":"string","name":"string","age":"string","sex":"Macho|Fêmea","color":"string","vaccinated":"boolean","neutered":"boolean" }

GET/api/cats/:id

Retorna detalhes de um gatinho específico.

Parâmetros

id( string )obrigatórioID unico do gatinho

Resposta

{ "id":1,"name":"Miau","color":"Laranja","sex":"Macho","age":"2 anos","vaccinated":true,"location":"Sao Paulo, SP" }

POST/api/cats

Cria um novo anúncio de doação.

Parâmetros

name( string )obrigatório

age( string )obrigatório

sex( string )obrigatório

color( string )obrigatório

location( string )obrigatório

contact( string )obrigatório

photo( string )opcional

Resposta

{ "name":"Mel","age":"3 meses","sex":"Fêmea","color":"Laranja","vaccinated":true }

PUT/api/cats/:id

Atualiza informações de um anúncio existente.

Parâmetros

id( string )obrigatório

Resposta

{ "success":"boolean","message":"string","data":"Cat" }

DELETE/api/cats/:id

Remove um anúncio de doação.

Parâmetros

id( string )obrigatório

Resposta

{ "success":"boolean","message":"string" }

Exemplos de Código

Veja como integrar a API em diferentes linguagens.

// Buscar todos os gatinhos
fetch('https://api.lovecats.com/api/cats')
  .then(res => res.json())
  .then(data => console.log(data));

// Criar novo anúncio
fetch('https://api.lovecats.com/api/cats', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-API-Key': 'sua-chave-api' },
  body: JSON.stringify({ name: 'Mel', age: '3 meses', sex: 'Fêmea', color: 'Laranja' })
}).then(res => res.json()).then(console.log);

import requests

response = requests.get('https://api.lovecats.com/api/cats')
cats = response.json()

data = { 'name': 'Mel', 'age': '3 meses', 'sex': 'Fêmea', 'color': 'Laranja' }
response = requests.post('https://api.lovecats.com/api/cats',
    json=data, headers={'X-API-Key': 'sua-chave-api'})
result = response.json()

# Buscar todos os gatinhos
curl https://api.lovecats.com/api/cats

# Criar novo anúncio
curl -X POST https://api.lovecats.com/api/cats   -H "X-API-Key: sua-chave-api"   -H "Content-Type: application/json"   -d '{"name":"Mel","age":"3 meses","sex":"Fêmea","color":"Laranja"}'

Agradecimentos

Izadora Cury Pierette, líder do projeto, agradece especialmente a toda a equipe da LoveCats pelo comprometimento e dedicação em construir esta plataforma.

Agradecemos também a todos os desenvolvedores que contribuíram ou venham a contribuir com melhorias e manutenção da nossa API. Cada linha de código faz diferença na vida de um gatinho!

Comece a Usar Agora

A LoveCats API é gratuita para ONGs, abrigos e projetos sociais. Para uso comercial, entre em contato.

Saiba mais sobre nós