Nova API V1.0 · Referência
Listar produtos por categoria
Retorna categorias e produtos no formato compatível com o API Legado, incluindo `pdv_codes` e o objeto adicional `fiscal` em cada produto. Com OAuth, exige o escopo `products:read`; a sessão do restaurante também é aceita.
Retorna categorias e produtos no formato compatível com o API Legado,
incluindo pdv_codes e o objeto adicional fiscal em cada produto.
Com OAuth, exige o escopo products:read; a
sessão do restaurante também é aceita.
Authorization
bearerAuth Access token OAuth obtido em POST /oauth/token ou sessão autenticada
do restaurante emitida pelo login Takeat. Tokens OAuth exigem os
escopos de cada operação. A sessão não usa escopos de integração e
fica limitada ao restaurant_id assinado. Chaves tk_ não são aceitas.
In: header
Query Parameters
Omitido para sessões de restaurante ou credenciais com uma única loja.
Obrigatório quando uma chave ou autorização OAuth multilojas, ou um
parceiro, cobre várias lojas. É validado contra as lojas atualmente
autorizadas pela credencial. Em uma sessão, um valor diferente do
restaurant_id assinado responde 403.
Filtra o recurso pela marca. A marca deve estar ativa, não removida e pertencer ao restaurante autorizado. Omitir preserva o comportamento agregado atual da rota.
Response Body
application/json
application/json
application/json
application/json
Enviar uma imagem de produto do cardápio POST
Requer products:write ou sessão de restaurante. Apenas um campo multipart file, JPEG/PNG/WebP de até 10 MiB e 25 megapixels. Conteúdo real é validado; animações são rejeitadas. Produz WebP de até 1600px e miniatura de até 400px, sem metadados. Upload não altera produtos. Use o id como image_id em criações ou edições no mesmo restaurante. Não permite arquivos genéricos nem exclusão.
Criar produto POST
Cria um produto em uma categoria não removida do restaurante. Com OAuth, exige `products:write`; a sessão do restaurante também é aceita. Não existe exclusão de produtos nesta API. Uma categoria indisponível pode receber produtos, mas não aparece no menu com only_available=true. Envie preços como números, não strings. Veja a [referência de campos](/externo/v1/campos-do-produto) para padrões de criação e efeitos sobre preços, disponibilidade e esgotamento.