InformeLegal API

Appearance

Changelog ​

Historial de versiones del contrato público. Las versiones se identifican en la ruta (/api/v1/...). Los cambios aditivos (nuevos endpoints, campos opcionales, nuevos payloads) no rompen el contrato; los cambios incompatibles darían lugar a una nueva versión (v2).

v1.1.0 — consulta por fuente ​

  • Nuevo endpoint POST /api/v1/sources/{source}/query: consulta directa a una fuente (igj, arca, bcra, informelegal), con el mismo envelope que Person Search más el campo source.
  • Nuevo endpoint GET /api/v1/sources: catálogo de fuentes publicadas, con claves, scopes, precio y si tu API Key está autorizada (authorized). No factura ni consume cuota.
  • Nuevos scopes: sources:read (audiencia) y provider:igj / provider:bcra / provider:informelegal (por fuente). provider:arca ya existía y ahora también gobierna la consulta directa a ARCA.
  • En la consulta directa, la falta del scope de una fuente devuelve 403 (en Person Search sigue siendo una exclusión silenciosa: la fuente no aparece y no es un error).

Aditivo: ninguna respuesta ni parámetro existente cambió.

v1.0.1 — documentación del payload informelegal.persona.v1 ​

  • Se documenta el payload informelegal.persona.v1, que PERSON_ADVANCED ya devolvía como enriquecimiento comercial en passthrough crudo. No es un cambio de comportamiento: es un payload que faltaba declarar en el contrato.

v1.0.0 — inicial ​

  • Endpoint público POST /api/v1/person-search/search.
  • Autenticación por API Key (Authorization: Bearer ilk_... o x-api-key).
  • Modelos PERSON_STANDARD y PERSON_ADVANCED.
  • Payloads por dominio: golden_record.person.v1, igj.company.v1, arca.padron.v1, bcra.credit.v1.
  • Errores 400/401/403/404/429; el 429 de rate-limit incluye retryAfterMs en el cuerpo (no hay cabecera Retry-After).
  • APIs complementarias: POST /api/v1/utils/email/validate y POST /api/v1/utils/phone/validate.

Nota sobre country ​

El request no incluye un campo country en v1. Se evaluó incorporarlo como contexto, pero hoy la resolución opera sobre datos de un único país y el campo no alteraría el resultado; publicarlo sería exponer un parámetro aceptado pero ignorado. Queda reservado para una versión futura, cuando exista resolución multi-país que lo utilice de forma efectiva.