REST API

REST (Representational State Transfer) es el estilo arquitectónico propuesto por Roy Fielding en 2000 que estructura las APIs HTTP alrededor de recursos identificados por URL y manipulados con verbos estándar (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`). Principios clave: - **Sin estado**: cada request contiene toda la información necesaria; el servidor no guarda contexto entre llamadas. - **Cliente-servidor**: separación clara de responsabilidades. - **Cacheable**: respuestas pueden marcarse como cacheables vía headers. - **Interfaz uniforme**: URLs predecibles, códigos de estado HTTP estándar (`200`, `400`, `401`, `404`, `429`, `500`). Una alternativa moderna es GraphQL — más flexible pero con curva de aprendizaje mayor. Para validación de identificadores, REST gana por simplicidad: un `POST` con un JSON pequeño devuelve un JSON pequeño. Normadata sigue REST estrictamente. La base es `https://api.normadata.io/v1/`. Cada endpoint corresponde a un dominio de validación (`validate/emails`, `validate/tax-ids`, `validate/accounts`, `validate/phones`, `validate/records`). Las requests usan `POST` con body JSON; las respuestas siguen el envelope JSON estándar. Autenticación por header `X-API-Key`. Errores con códigos HTTP convencionales y body JSON con `code` y `message` legibles.