Nova API V1.0 · Referência
Consultar categoria de produtos
Retorna uma categoria de produtos não removida do restaurante autorizado. Com OAuth, exige `products:read`; a sessão autenticada do restaurante também é aceita. Escopo products:read ou sessão autenticada de restaurante. Isolamento pelo restaurante autorizado. Disponibilidades de cada canal são independentes; omissões preservam campos. Marca deve pertencer ao restaurante e não pode ser trocada na edição. Não expõe exclusão, imagens, horários ou configurações de integração.
Retorna uma categoria de produtos não removida do restaurante
autorizado. Com OAuth, exige products:read; a sessão autenticada do
restaurante também é aceita.
Escopo products:read ou sessão autenticada de restaurante. Isolamento pelo restaurante autorizado. Disponibilidades de cada canal são independentes; omissões preservam campos. Marca deve pertencer ao restaurante e não pode ser trocada na edição. Não expõe exclusão, imagens, horários ou configurações de integração.
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
Path Parameters
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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
Criar categoria de produtos POST
Cria uma categoria para uma marca não removida do restaurante autorizado. Com OAuth, exige `products:write`; a sessão autenticada do restaurante também é aceita. Os campos de disponibilidade e ordenação omitidos usam os defaults do cadastro. O nome é normalizado removendo espaços nas extremidades. Escopo products:write ou sessão autenticada de restaurante. Isolamento pelo restaurante autorizado. Disponibilidades de cada canal são independentes; omissões preservam campos. Marca deve pertencer ao restaurante e não pode ser trocada na edição. Não expõe exclusão, imagens, horários ou configurações de integração.
Editar parcialmente categoria de produtos PUT
Atualização parcial: campos omitidos permanecem intactos. Com OAuth, exige `products:write`; a sessão autenticada do restaurante também é aceita. `brand_id` não pode ser alterado. Envie `updated_at` da última consulta como `expected_updated_at` para rejeitar uma revisão obsoleta. O nome é normalizado removendo espaços nas extremidades. Escopo products:write ou sessão autenticada de restaurante. Isolamento pelo restaurante autorizado. Disponibilidades de cada canal são independentes; omissões preservam campos. Marca deve pertencer ao restaurante e não pode ser trocada na edição. Não expõe exclusão, imagens, horários ou configurações de integração.