Empresa que opera com tecnologia própria — marca grande, rede de pet shops, distribuidor — não quer digitar catálogo manualmente em mais uma plataforma. Não quer conciliar estoque entre 3 sistemas. Não quer gerar relatório copiando dado de tela. A camada de API e Integrações do TudoPet existe pra eliminar trabalho duplicado e deixar o sistema da empresa conversando direto com o nosso, em tempo real, com auditoria e segurança.
O que está disponível via API
Padrões técnicos
REST sobre HTTPS — endpoints versionados (/v1/, /v2/ quando houver breaking change). Sem suporte a chamada via HTTP simples.
Autenticação por API Key + OAuth 2.0 quando aplicável — chave por aplicação, escopo definido (read, write, admin), revogação a qualquer momento.
Formato JSON em request e response — campos em camelCase, datas em ISO 8601 com timezone, valores monetários em centavos (BRL).
Paginação por cursor — todas as listagens paginadas pra evitar response gigante. Padrão de 50 itens, máximo 200 por página.
Rate limit — 600 requisições por minuto por API Key no plano padrão; superior negociável pra clientes enterprise.
Idempotência — operações de escrita aceitam header Idempotency-Key pra evitar duplicação em retries.
Webhooks pra eventos críticos
Em vez de polling contínuo, webhooks entregam evento em tempo real:
| Evento | Quando dispara |
|---|---|
pedido.criado | Tutor confirmou compra no marketplace |
pedido.pago | Pagamento confirmado |
pedido.cancelado | Cancelamento pelo tutor ou vendedor |
agendamento.criado | Tutor agendou serviço |
agendamento.cancelado | Cancelamento de agendamento |
estoque.baixo | Estoque caiu abaixo do mínimo configurado |
avaliacao.recebida | Tutor avaliou produto ou serviço |
afiliado.venda | Venda atribuída a afiliado do parceiro |
pagamento.repassado | TudoPet repassou pagamento ao vendedor |
Webhook é entregue via POST HTTPS para URL configurada pelo parceiro. Retry exponencial em caso de falha, até 24h. Assinatura HMAC-SHA256 pra validar autenticidade.
SDKs oficiais
JavaScript/TypeScript (Node.js + navegador): npm install @tudopet/sdk
import { TudoPet } from '@tudopet/sdk';
const tp = new TudoPet({ apiKey: process.env.TUDOPET_KEY });
const produto = await tp.catalogo.criar({
nome: 'Ração Premium Adulto',
preco: 18900, // R$ 189,00 em centavos
categoria: 'alimentacao',
estoque: 240,
});Python: pip install tudopet
from tudopet import TudoPet
tp = TudoPet(api_key=os.environ['TUDOPET_KEY'])
pedidos = tp.pedidos.listar(status='pendente', limite=100)
for pedido in pedidos:
enviar_pra_separacao(pedido)
Outras linguagens — sem SDK oficial ainda. API REST funciona com qualquer cliente HTTP (PHP, Ruby, Go, .NET). SDKs comunitários começam a aparecer.
Sandbox e ambiente de teste
Toda integração começa em ambiente de sandbox (sandbox.api.tudopet.com.br):
- API Key separada do produção (não vaza dado real)
- Dados fictícios de tutores, pets, pedidos
- Comportamento idêntico à produção (mesmas regras, mesmas validações)
- Logs preservados pra debug
- Reset diário (apaga dados fictícios criados)
Integração validada em sandbox → migra pra produção com mudança de URL e API Key. Sem surpresa.
Documentação
Documentação completa em docs.tudopet.com.br:
- Referência endpoint por endpoint (com exemplos curl, JS, Python)
- Guias de integração por caso de uso (marketplace, agendamento, afiliados)
- Tutoriais passo a passo (primeira venda via API, primeiro webhook ativo)
- Changelog de versões da API
- Status page (uptime real-time, incidentes históricos)
Documentação aberta — não exige cadastro pra ler.
Casos de uso
Marca grande sincroniza catálogo automático:
- Sistema interno da marca tem 4.200 SKUs
- Job noturno usa API TudoPet pra sincronizar preço + estoque
- Mudança no PIM da marca reflete em TudoPet em < 5 min
- Sem digitação manual
Rede de pet shops sincroniza agenda multi-unidade:
- 18 unidades em SP
- Sistema interno gerencia agenda
- API TudoPet expõe slots disponíveis pra tutores
- Webhook avisa nova reserva pra liberação interna
Distribuidor automatiza pedido B2B:
- Pet shops parceiros do distribuidor consomem catálogo via API
- Pedido criado no app do TudoPet vira pedido no ERP do distribuidor
- Faturamento automático
- Logística disparada via webhook
Marca de plano de saúde pet captura leads:
- Banner CTA no app TudoPet
- Tutor preenche interesse → webhook entrega lead no CRM da marca
- Equipe comercial trabalha lead em < 5 min
- Conversão atribuída pelo TudoPet
Quem tem acesso à API
Plano gratuito de marketplace ou agendamento — acesso a APIs básicas (catálogo, agendamento) com rate limit reduzido. Suficiente pra pet shop pequeno automatizar listagem.
Parceria Estratégica — APIs completas, rate limit alto, gerente técnico dedicado, SDKs prioritários, sandbox sem reset, SLA de 99.9% de uptime contratual.
API não é “feature premium” inacessível — é parte da plataforma, com camadas que escalam com o tamanho do parceiro.
Versionamento e deprecação
Mudança de API segue regra:
- Adição (campo novo opcional, endpoint novo) — backward compatible, sem aviso
- Mudança não-breaking (default novo, campo opcional vira recomendado) — aviso 30 dias antes
- Breaking change (campo removido, comportamento alterado) — nova versão major (
/v2/), suporte à versão antiga por mínimo 12 meses
Parceiro nunca acorda com integração quebrada sem aviso.
Suporte técnico
Plano gratuito — chat de suporte durante horário comercial, fórum aberto da comunidade.
Parceria Estratégica — chat 24/7, gerente técnico dedicado, code review gratuito do código de integração antes do go-live, plantão pra incidente crítico.
Integração não é “vira pra você descobrir como fazer” — TudoPet acompanha até ficar estável.
Roadmap público
APIs em desenvolvimento e ETA público em roadmap.tudopet.com.br:
- Q3/2026 — API de Petinder (com permissão estrita, casos específicos)
- Q4/2026 — Webhook de comportamento (eventos de engajamento do tutor)
- Q1/2027 — GraphQL endpoint experimental
- Q2/2027 — Webhook de NPS pós-atendimento
Parceiro grande pode votar prioridades e influenciar o que vem primeiro.
Conformidade
- LGPD — todo acesso a dado pessoal é logado, rastreado e auditável
- PCI-DSS — pagamento processado por gateway certificado, parceiro não recebe dado de cartão
- ISO 27001 (em curso) — controle de acesso, criptografia, gestão de incidente
- Soc 2 Type II (planejado pra 2027) — pra atender parceiros grandes que exigem
API séria pra empresa séria. Sem amadorismo, sem surpresa de compliance.