# Zouti API

> Documentação da API pública da Zouti: leia os pedidos da sua conta a partir de ERP, CRM, planilha ou BI.

- [Introdução](https://developers.zouti.com.br/index.md): Leia os pedidos da sua conta Zouti a partir do seu ERP, CRM, planilha ou BI.
- [Primeiros passos](https://developers.zouti.com.br/quickstart.md): Crie uma chave de API e faça a primeira chamada em menos de 5 minutos.
- [Autenticação](https://developers.zouti.com.br/concepts/authentication.md): Como enviar a chave de API, guardá-la, trocá-la e revogá-la.
- [Erros](https://developers.zouti.com.br/concepts/errors.md): Formato do erro, o que fazer com cada code e quando repetir a requisição.
- [Limites de requisição](https://developers.zouti.com.br/concepts/rate-limits.md): As três camadas de limite, os headers RateLimit-* e como ficar dentro deles.
- [Paginação](https://developers.zouti.com.br/concepts/pagination.md): Como percorrer listas com cursor e o que cada ordem garante durante a leitura.
- [Sincronização de pedidos](https://developers.zouti.com.br/concepts/sync.md): Mantenha uma cópia local dos pedidos novos e alterados com uma consulta periódica.
- [Request-Id](https://developers.zouti.com.br/concepts/request-ids.md): O identificador de cada requisição: onde ele vem e por que guardá-lo.
- [Versionamento e compatibilidade](https://developers.zouti.com.br/concepts/versioning.md): O que pode mudar dentro da v1 e como escrever uma integração que não quebra.
- [Sobre os dados](https://developers.zouti.com.br/concepts/data.md): De onde vêm os pedidos, o que entra e o que fica de fora, e como tratar os dados do comprador.
- [Objeto pedido](https://developers.zouti.com.br/api-reference/order-object.md): Todos os campos do pedido e o significado de cada valor.
- [Listar pedidos](https://developers.zouti.com.br/api-reference/orders/list.md): Pedidos em que a conta é dona ou coprodutora. Pagine com `cursor` até `has_more` ser `false`.
- [Buscar pedido](https://developers.zouti.com.br/api-reference/orders/get.md): Um pedido da conta (dona ou coprodutora). Pedido inexistente e pedido de outra conta respondem o mesmo 404.
- [Changelog](https://developers.zouti.com.br/changelog.md): As mudanças da API pública da Zouti, da mais nova para a mais antiga.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.