Introdução

Base URL e prefixo

Todas as rotas de negócio ficam sob o prefixo /v1. Use a base URL de sandbox para testes e a de produção nas integrações reais. O seletor de ambiente no menu lateral troca a URL de todos os exemplos desta documentação.

Produção: https://api.beefood.app
Sandbox: https://api-sandbox.beefood.app

Headers

Content-Type: application/json — em requisições com body JSON.
Authorization: Bearer <accessToken> — rotas autenticadas da API.

Datas e horários

Datas e horários da API parceiro vêm em ISO 8601 com o fuso do restaurante (ex.: -03:00), não em UTC (Z).

Fluxo sugerido

Continue em Autenticação.

base

Produção  ◀: https://api.beefood.app
Sandbox: https://api-sandbox.beefood.app
Prefixo de negócio: /v1

fluxo

1. O restaurante cria a credential      → clientId + clientSecret (exibidos uma vez)
2. POST /v1/oauth/token          → accessToken + refreshToken
3. Chamadas /v1/…                → Authorization: Bearer <accessToken>
4. POST /v1/oauth/token          → renovação com refreshToken
5. POST /v1/oauth/revoke         → logout da integração