Iniciar preparo
A cozinha começou.
Autorização
oauth2 orders:writeOAuth 2.0 client_credentials. Troque client_id e client_secret por um token em
POST /oauth/token e envie Authorization: Bearer <access_token>. O token vale 3600
segundos, sem refresh token. Os escopos são definidos pelo lojista ao criar a credencial e
não podem ser alterados depois; o token carrega exatamente os escopos da credencial.
Em: header
Escopo: orders:write
Parâmetros de caminho
Identificador do pedido (GUID). É o orderId dos eventos e o id do pedido. Um valor que não é GUID responde 404 no formato ProblemDetails.
uuidParâmetros de cabeçalho
Extensão MeuPedido: não existe no padrão 1.4.0.
Chave de idempotência, qualquer string de até 128 caracteres escolhida por você, única
por credencial (um UUID por tentativa lógica, ou um valor derivado como
confirm-{orderId}). Mesma chave com a mesma requisição (mesma rota, mesma ação, mesmo
corpo) devolve a resposta gravada na primeira execução, com o mesmo status e o mesmo corpo,
sem executar de novo, por 24 horas. Mesma chave com requisição diferente responde
409 idempotency_key_reuse. Respostas 202, 404 e 422 são gravadas; 5xx não, para
que a repetição execute de verdade. Em timeout, repita com a mesma chave.
Acima de 128 caracteres a resposta é 400 invalid_idempotency_key e nada é executado:
128 é o tamanho que a API grava, e aceitar uma chave maior seria aplicar o comando sem a
proteção que você pediu.
Este parâmetro não traz example de propósito: a chave muda a cada intenção nova, e um
valor fixo, repetido do playground ou do cURL copiado numa segunda ação, responderia 409.
length <= 128Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.meupedido.io/open-delivery/v1/orders/9b1e2d3c-4f5a-4b6c-8d7e-0f1a2b3c4d5e/startPreparation" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Idempotency-Key: startPreparation-9b1e2d3c-4f5a-4b6c-8d7e-0f1a2b3c4d5e"{ "status": "accepted", "situation": "PREPARING"}