Adiciona detalhamento do motivo_id nos endpoints de cancelamento (V1 e V2)

[Mateus-Fernandes284]

Resumo

• Documenta os 20 valores possíveis de motivo_id diretamente no schema do campo, cobrindo os endpoints de cancelamento de corridas (pages/v1/openapi.json, pages/v2/openapi.json) e entregas (pages/v1/openapi-entregas.json, pages/v2/openapi-entregas.json).
• Corrige um gap na numeração (14, 15 e 20 estavam ausentes da descrição e do enum) presente tanto na V1 quanto na V2, pois, os seguintes motivos nunca haviam sido documentados:
  • 14: Despachado na plataforma do iFood
  • 15: Cancelado via iFood
  • 20: Cancelado por redistribuição
• Adiciona enum com os 20 valores válidos de motivo_id na V2, evitando envio de valores inválidos (V1 já possuía o enum, agora completo).
• Marca motivo_id como campo required no endpoint de cancelamento de entregas da V2 (estava ausente do array required).
• Adiciona example (motivo_id: 3) no endpoint de cancelamento da V2 para entregas (corridas já possui) para facilitar o uso via "Try it".

Motivação

A documentação da V2 apenas indicava o tipo (integer) do campo motivo_id, sem explicar o significado de cada motivo, diferente da V1, que já detalhava os motivos de cancelamento tanto para corridas quanto para entregas. Ao portar o detalhamento da V1 para a V2, foi identificado que a própria V1 tinha um gap na sequência (13 -> 16, pulando 14, 15 e 20), então a tabela motivo_cancelamento (20 linhas) foi usada como fonte de verdade para corrigir as quatro documentações.

Arquivos alterados

• pages/v1/openapi.json
• pages/v1/openapi-entregas.json
• pages/v2/openapi.json
• pages/v2/openapi-entregas.json

[gaudinho]

PR de documentação bem executado: preenche o gap dos motivos 14, 15 e 20 nas 4 specs OpenAPI, alinha description + enum e usa a tabela motivo_cancelamento como fonte de verdade. Diff mínimo, JSONs válidos e mudanças coerentes com o PR body.

The base branch was changed.

[Mateus-Fernandes284]

/gaudinho review

[gaudinho]

✅ Review postada — #25 (review)

job_id: mintlify-docs-25-1783115443533-cec5

[gaudinho]

Documentação OpenAPI consistente entre V1/V2 (corridas e entregas), preenche o gap real dos motivos 14, 15 e 20 usando a tabela motivo_cancelamento como fonte de verdade, adiciona enum + example na V2 e marca motivo_id como required no cancelamento de entregas V2. Diff mínimo, sem risco de segurança/correctness.

[jfelipends]

@Mateus-Fernandes284 Ajusta os conflitos, por favor.