Nova API V1.0 · Referência
Criar produto
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.
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 para padrões
de criação e efeitos sobre preços, disponibilidade e esgotamento.
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, chaves de restaurante e parceiros
ligados a um único restaurante. Obrigatório para parceiros
multi-restaurante e validado contra os restaurantes autorizados para a
credencial. Em uma sessão, um valor diferente do restaurant_id
assinado responde 403.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
Consultar cardápio publicado GET
Retorna as seções vendidas ao cliente, seus produtos e, opcionalmente, os grupos de complementos. Com OAuth, exige o escopo `menu:read`; a sessão do restaurante também é aceita sem escopos de integração. O contrato remove registros excluídos, categorias de embalagem e espelhos internos do iFood. Preços, disponibilidade e apresentação são agrupados em objetos. `pricing.resolved.base` aplica a prioridade dos preços do canal; `pricing.resolved.minimum` soma as escolhas obrigatórias. Disponibilidade avalia canal, horários, esgotamento e escolhas válidas. Não retorna objeto de restaurante nem aliases do contrato anterior. Não substitui validação de checkout, abertura da loja ou capacidade de entrega.
Listar produtos por categoria GET
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.