[codex] Atualiza limites da API de integração

[jfelipends]

O que mudou

• Atualiza a seção de rate limit das introduções v1 e v2.
• Documenta os grupos de paths da API de integração conforme mchapigw/etc/mchapigw.d/ratelimit-rules.yml.
• Explicita o agrupamento por api-key e a exceção por int-key para integrador externo.

Impacto

• A documentação passa a refletir os limites de bloqueio configurados no gateway.
• Grupos que apenas geram log são marcados como sem bloqueio configurado.

Validação

• `ruby -e 'require "json"; JSON.parse(File.read("docs.json")); JSON.parse(File.read("pages/v1/openapi.json")); JSON.parse(File.read("pages/v2/openapi.json")); puts "json ok"'
• ruby -e 'ARGV.each { |f| s=File.read(f); abort("missing title in #{f}") unless s.match?(/^title:/); abort("unclosed table in #{f}") unless s.include?("| Padrão | /api/integracao/*|api-key | 1000 requisições por minuto |") }; puts "mdx smoke ok"' pages/v1/referencia/introducao.mdx pages/v2/referencia/introducao.mdx
• git diff --check
• mint broken-links com Node 24: falhou por link quebrado existente em essentials/images.mdx para /writing-content/embed.
• Preview local validado em http://localhost:3000/pages/v2/referencia/introducao#rate-limit e http://localhost:3000/pages/v1/referencia/introducao#rate-limit.

[gaudinho]

✅ Review postada — #4 (review)

job_id: mintlify-docs-4-1780929068142-f7fa

[gaudinho]

Documentação dos rate limits da API de integração foi atualizada para refletir os grupos configurados em mchapigw/etc/mchapigw.d/ratelimit-rules.yml, incluindo agrupamento por api-key/int-key e a nota sobre fatores multiplicadores. Diff mínimo, escopo claro e idêntico entre v1 e v2.

[jfelipends]

/gaudinho review

[gaudinho]

✅ Review postada — #4 (review)

job_id: mintlify-docs-4-1780932735622-ab66

[gaudinho]

Atualização de documentação coerente com ratelimit-rules.yml do gateway: detalha grupos, agrupamento por api-key/int-key, multiplicadores e janela deslizante na v1; marca v2 como WIP. Diff mínimo, sem efeitos colaterais em código.

[gaudinho]

Nit (Readability) — a entrada /api/integracao/saldoCreditosCondutor/ (com barra final) ao lado de /api/integracao/saldoCreditosCondutor parece redundante para o leitor humano da doc, mesmo que reflita literalmente o YAML do gateway. Considere consolidar em uma única linha (ex.: /api/integracao/saldoCreditosCondutor[/...]) ou adicionar nota curta explicando por que ambos aparecem, evitando dúvida sobre se é typo.

[gaudinho]

Nit (Readability) — as duas linhas com Sem bloqueio configurado. O gateway registra log a partir de 10 requisições por minuto. repetem texto longo dentro da coluna Limite. Sugestão informativa: extrair como nota de rodapé abaixo da tabela e referenciar via marcador (ex.: Somente log¹), reduzindo ruído visual na tabela e facilitando manutenção quando o limiar mudar.

[gaudinho]

Sugestão (Readability) — o bloco explicativo sobre multiplicadores é útil, mas pode confundir integradores que não têm visibilidade dos fatores configurados. Vale uma frase curta dizendo onde/como o cliente consulta o multiplicador efetivo da chave dele (ou que o suporte deve ser contatado), para o leitor não ficar com a impressão de que o limite da tabela é o efetivo.

[gaudinho]

Sugestão (Readability) — marcar a seção como WIP é honesto, mas remover a tabela antiga deixa integradores v2 sem nenhuma referência de limite até a definição final. Considere manter um limite default genérico ou apontar explicitamente para a tabela da v1 enquanto a v2 não tem regras próprias, evitando regressão de informação útil.

[marcos-marques-gaudium]

Acho relevante deixar um quadro de Rate Limit na V2 baseado no da V1, enquanto estiver em WIP, pq o rate limit da V2 atualmente tem como teto os rate limits dos endpoints de V1, já que internamente é feito o redirecionamento das requests.