JSON envelope
Estructura JSON común que envuelve la respuesta de cada endpoint de Normadata con metadatos consistentes.
Cada endpoint batch de Normadata comparte el mismo "envelope" JSON: la request es `{ "items": [...] }` y la respuesta es `{ "results": [...] }`. Independientemente del endpoint invocado (`/v1/validate/tax-ids`, `/v1/validate/accounts`, `/v1/validate/emails`, `/v1/validate/phones`, `/v1/validate/records`), el sobre tiene la misma forma — el mismo endpoint sirve para 1 o N ítems: ```json { "results": [ { "id": "1", "valid": true, "normalized": "..." }, { "id": "2", "valid": false, "error": "..." } ] } ``` Cómo funciona: - **`items`**: array de ítems a validar (hasta 1.000; 500 en `/records`). Cada ítem lleva un `id` (o `reference_id` en records) que vos provéès. - **`results`**: un resultado por ítem, en el mismo orden y correlacionado por el `id` que mandaste (se devuelve verbatim). - **Por ítem**: `valid`, el valor `normalized` y, cuando `valid` es false, un `error` accionable. Un ítem que no se pudo validar no corta el resto del lote. El envelope hace que un mismo cliente procese lotes sin importar el endpoint, y mapee cada resultado a su entrada de origen por `id`.