feat: reestrutura exemplos em pt/en e alinha contratos com a API#24
Merged
Conversation
LeoFalco
previously approved these changes
Jun 18, 2026
Cria uma versão multilíngue do repositório de exemplos, separando em
`pt/exemplos` (português), `en/examples` (inglês) e `es/ejemplos`
(espanhol), com `core/` compartilhado na raiz. Antes de duplicar,
corrige 5 exemplos que estavam inconsistentes com o contrato atual da
API amonamarth:
- POST /pendencies: usa objetos `company: {id}` / `pendencyType: {id}`
em vez de `companyId` / `pendencyTypeId` (que retornavam 422).
- POST /equipment-types: valores de `customFields[].type` corrigidos
para o enum real (QUESTION/NUMBER/DATE/MULTIPLE_CHOICE) e assert.
- GET /companies: `nameEq` / `orderBy` / `direction` (os nomes
`nameContains` / `orderColumn` / `orderDirection` não existem e eram
ignorados silenciosamente).
- GET /locations/:id/service-providers: remove o `segmentId` não
suportado pelo endpoint.
- POST /pendencies/:id/actions/conclude: remove o body descartado.
Nas traduções (en/es), comentários, logs e textos criados foram
traduzidos, mas os valores de lookup (nameEq, nomes de dados reais)
foram mantidos em português para não quebrar as consultas.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
f7a9d34 to
8b51124
Compare
LeoFalco
approved these changes
Jun 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Contexto
Um cliente estava com dificuldade de entender a API de integração. Ao revisar este repositório de exemplos contra o contrato atual da API
amonamarth, encontrei 5 exemplos inconsistentes e, na sequência, reorganizei o repositório em uma versão bilíngue (PT/EN) para facilitar o consumo.O que muda
1. Correções de consistência com a API (5 exemplos)
POST /pendenciescompanyId/pendencyTypeId(planos) → 422company: {id}/pendencyType: {id}POST /equipment-typescustomFields[].typecom valores inexistentes (text/select/…)QUESTION/NUMBER/DATE/MULTIPLE_CHOICE(+ assert corrigido)GET /companiesnameContains/orderColumn/orderDirectionnão existem (ignorados em silêncio)nameEq/orderBy/directionGET /locations/:id/service-providerssegmentIdnão é suportado pelo endpointPOST /pendencies/:id/actions/conclude2. Reestruturação bilíngue
pt/exemplos/manutencoes/criar-manutencao-com-endereco.js↔en/examples/maintenances/create-maintenance-with-address.js).core/compartilhado (../../../core/) e o path dodata/no exemplo de anexo (../../../../data).nameEq, nomes de dados reais comoManutenção corretiva,001 - Ar condicionado) foram mantidos em português para não quebrar as consultas contra os dados reais da conta.Observação
get-canceled-maintenancestinha umforvazio no original; recebeu umconsole.logpor item para passar no lint e ilustrar o uso. É a única mudança de comportamento além de mover/traduzir.Verificação
node_modules/.bin/eslint .→ exit 0.data/corretamente (chegam no passo HTTP, semENOENT).🤖 Generated with Claude Code