Introdução à V1.0 · Takeat API

A API Externa V1.0 é a nova superfície de integração da Takeat. Suas rotas de dados aceitam tokens OAuth2 de curta duração e a sessão autenticada do próprio restaurante. As rotas são versionadas sob /v1.

Nova API disponível

A V1.0 é a versão recomendada para todas as novas integrações. O API Legado será removido em breve; aplicações existentes devem seguir o guia de migração.

Base URL

https://public-api.takeat.app

Todos os caminhos desta versão usam essa origem. O endpoint de token é version-neutral (/oauth/token); os recursos de dados começam com /v1.

Como funciona

Crie uma chave no AI Builders

Entre em ai-builders.takeat.app, crie uma credencial tk_live_ ou tk_test_ e guarde o segredo exibido uma vez.

Troque a chave por um access token

Envie a chave como api_key para POST /oauth/token com grant_type=api_key. A resposta contém um bearer token curto e um refresh token rotativo.

Consuma a API V1.0

Envie o access token OAuth como Bearer nas chamadas a /v1. Uma interface Takeat já autenticada também pode enviar a sessão do restaurante como Bearer. Nunca envie a chave tk_ diretamente para uma rota de dados.

Com OAuth, a operação exige o escopo indicado em seu contrato. Com uma sessão de restaurante, o acesso fica preso ao restaurant_id assinado no token e não depende dos escopos de integração.

Recursos disponíveis

Marcas

Marcas e identificação comercial do restaurante.

NF-e recebidas

Notas pendentes ou confirmadas e detalhes fiscais por assunto.

Cardápio publicado

Seções, produtos, preços efetivos e grupos de complementos por canal.

Sessões de comanda

Comandas, contas, pedidos, pagamentos e dados fiscais em janelas de até três dias.

Produtos e complementos

Os catálogos compatíveis com a resposta do API Legado, agora sob /v1.

Gerenciar produtos

Criação, edição e disponibilidade independente para presencial e delivery.

Métodos de pagamento

Métodos habilitados para o restaurante da credencial.

Clientes do Clube

Consulta paginada aos clientes do programa de fidelidade.

Lançamentos financeiros

Contas a pagar e receber, notas, itens, filtros e totais do período.

Escopo da primeira versão

Pedidos de entrada e webhooks ainda não fazem parte da superfície publicada. Eles serão documentados somente quando contrato, segurança e implementação estiverem disponíveis.

Próximos passos

Consulte também Gerenciar complementos para editar opções, preços, fiscal e disponibilidade, individualmente ou em lote.