Nova API V1.0 · Referência
Editar vários produtos atomicamente
Requer products:write ou sessão de restaurante. Corpo é um array de 1–100 edições parciais. IDs repetidos causam 400 duplicate_product_ids. Qualquer falha impede todas as alterações. Zero é permitido nos preços. expected_updated_at permite impedir a aplicação de uma revisão obsoleta. Os campos têm os mesmos efeitos da edição individual; consulte a [referência de campos](/externo/v1/campos-do-produto).
Requer products:write ou sessão de restaurante. Corpo é um array de 1–100 edições parciais. IDs repetidos causam 400 duplicate_product_ids. Qualquer falha impede todas as alterações. Zero é permitido nos preços. expected_updated_at permite impedir a aplicação de uma revisão obsoleta. Os campos têm os mesmos efeitos da edição individual; consulte a referência de campos.
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.
Pelo menos um campo editável é necessário; expected_updated_at e id sozinhos não constituem uma alteração. Campos omitidos mantêm seus valores, sem aplicar os defaults de criação. null limpa apenas campos que o aceitam; zero é um preço válido e não ativa fallback. Preços são números JSON.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
Alterar disponibilidade por canal PATCH
Altera `available` (presencial) e/ou `available_in_delivery` (delivery). Ao menos um campo é obrigatório. Com OAuth, exige `products:write`; a sessão do restaurante também é aceita. Os canais são independentes. Para marcar ou reverter esgotamento, envie sold_off no PUT individual ou em lote, não nesta rota.
Editar produto PUT
Atualização parcial: campos ausentes permanecem intactos. Com OAuth, exige `products:write`; a sessão do restaurante também é aceita. null limpa descrição e preços opcionais; zero define preço zero. Alterar o preço base não encerra uma promoção existente. Consulte a [referência de campos](/externo/v1/campos-do-produto).