Pular para o conteúdo principal
As mudanças da API ficam registradas aqui. Dentro da v1, toda mudança é aditiva: veja Versionamento e compatibilidade.
v1
Primeira versão da API pública da Zouti, só leitura, para levar os pedidos da conta a ERP, CRM, planilha ou BI.Recursos
  • GET /v1/orders: lista os pedidos da conta e os de coprodução, com filtros por status, payment_method, created_gte/created_lt e updated_gte/updated_lt.
  • GET /v1/orders/{id}: busca um pedido pelo id.
Base comum
  • Autenticação por chave de API da conta, no header Authorization: Bearer, criada em Configurações → Chaves de API.
  • Paginação por cursor, sem limite de profundidade.
  • Sincronização incremental com sort=updated_at_asc e os filtros updated_gte/updated_lt.
  • Limites de requisição por conta (rajada de 20 e 10 por segundo) e por IP, com os headers RateLimit-* e Retry-After.
  • Formato de erro único, com code estável, e Request-Id em toda resposta da API (as respostas da borda, como o 429 por IP, vêm sem ele).