REST API
Estilo arquitetural para APIs HTTP baseado em recursos, verbos padrão e respostas sem estado; o modelo mais comum para integrações modernas.
REST (Representational State Transfer) é o estilo arquitetural proposto por Roy Fielding em 2000 que estrutura APIs HTTP em torno de recursos identificados por URLs e manipulados com verbos padrão (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`). Princípios-chave: - **Sem estado**: cada requisição carrega todas as informações necessárias; o servidor não guarda contexto entre chamadas. - **Cliente-servidor**: separação clara de responsabilidades. - **Cacheável**: respostas podem ser marcadas como cacheáveis via headers. - **Interface uniforme**: URLs previsíveis, códigos de status HTTP padrão (`200`, `400`, `401`, `404`, `429`, `500`). Uma alternativa moderna é GraphQL — mais flexível mas com curva de aprendizado maior. Para validação de identificadores, REST ganha pela simplicidade: um `POST` com um JSON pequeno retorna um JSON pequeno. A Normadata segue REST estritamente. A base é `https://api.normadata.io/v1/`. Cada endpoint corresponde a um domínio de validação (`verify`, `verify/tax-id`, `verify/bank`, etc.). Requisições usam `POST` com body JSON; respostas seguem o envelope JSON padrão. Autenticação via header `X-API-Key`. Erros com códigos HTTP convencionais e body JSON com `code` e `message` legíveis.