# Tarevo Developers

> Documentação oficial da Tarevo Public Partner API V1. Plataforma de integração para food service: pedidos, cardápio, clientes, webhooks com HMAC-SHA256, autenticação OAuth 2.0 e ambiente Sandbox autônomo.

## Contratos e Especificações Canônicas
- [OpenAPI 3.1 Spec (JSON)](https://developers.tarevo.com.br/openapi.json): Especificação de todas as rotas, parâmetros, cabeçalhos e respostas.
- [OpenAPI 3.1 Spec (YAML)](https://developers.tarevo.com.br/openapi.yaml): Versão YAML da especificação de contrato.
- [Postman Collection](https://developers.tarevo.com.br/tarevo-partner-api-v1.postman_collection.json): Coleção de requisições prontas com autenticação automatizada.
- [Contexto Consolidado (Full)](https://developers.tarevo.com.br/llms-full.txt): Documento unificado de documentação para LLMs de janela longa.

## Getting Started & Sandbox
- [Quickstart (< 10 minutos)](https://developers.tarevo.com.br/docs/quickstart.md): Como obter credenciais sandbox, gerar token e fazer a primeira chamada.
- [Autenticação OAuth 2.0](https://developers.tarevo.com.br/docs/authentication.md): Fluxo Client Credentials, tokens JWT e segurança default-deny.
- [Ambiente Sandbox](https://developers.tarevo.com.br/docs/sandbox.md): Provisionamento de restaurante de teste, reset e gerador de pedidos em 7 cenários.

## Recursos da API V1
- [Pedidos (Orders)](https://developers.tarevo.com.br/docs/orders.md): Leitura de pedidos em tempo real, status, itens e paginação por cursor.
- [Clientes (Customers)](https://developers.tarevo.com.br/docs/customers.md): Consulta de perfis de clientes para CRMs e fidelidade.
- [Cardápio (Catalog)](https://developers.tarevo.com.br/docs/catalog.md): Leitura de categorias, produtos, fotos e adicionais.

## Confiabilidade & Arquitetura
- [Webhooks & Assinatura HMAC](https://developers.tarevo.com.br/docs/webhooks.md): Notificações push em tempo real, cálculo de HMAC-SHA256 e retentativas exponenciais.
- [Idempotência](https://developers.tarevo.com.br/docs/idempotency.md): Uso do cabeçalho Idempotency-Key para prevenir duplicidades em mutações.
- [Rate Limiting](https://developers.tarevo.com.br/docs/rate-limits.md): Janelas deslizantes no Redis, cabeçalhos 429 e Retry-After.
- [Catálogo de Erros](https://developers.tarevo.com.br/docs/errors.md): Padrão RFC 9457 Problem Details para códigos de erro.

## Governança & IA
- [Homologação para Produção](https://developers.tarevo.com.br/docs/homologation.md): Checklist de requisitos para ativação em lojas reais.
- [Solução de Problemas](https://developers.tarevo.com.br/docs/troubleshooting.md): Diagnóstico para 401, HMAC incorreto e escopos ausentes.
- [Open Delivery](https://developers.tarevo.com.br/docs/open-delivery.md): Alinhamento com o padrão aberto da Abrasel.
- [Recursos para IA & MCP](https://developers.tarevo.com.br/ai): Conector Model Context Protocol (MCP) e biblioteca de prompts universais.