Integraciones API (método POST)

El Lector de DPI Automático utiliza tecnología OCR para leer información impresa del DPI (código PDF417 y texto visible) y envía los datos alfanuméricos capturados a un endpoint HTTP(s) que expone el cliente o institución. EB SolTech es proveedor tecnológico; la recepción, tratamiento y resguardo en la API del cliente es responsabilidad exclusiva del cliente.

Endpoint del cliente

Método POST con autenticación y red bajo control del cliente.

POST https://api.su-dominio.tld/dpi/ingreso
Authorization: Bearer TOKEN
Content-Type: application/json

Payload de ejemplo

Modelo sugerido (ajustable por contrato):

{
  "source": "lector-dpi-ebsoltech",
  "timestamp": "2025-01-15T10:23:45Z",
  "deviceId": "EQUIPO-123",
  "dpiData": {
    "cui": "1234567890101",
    "primerNombre": "JUAN",
    "primerApellido": "PEREZ"
  },
  "meta": {
    "modoLectura": "OCR"
  }
}

Respuestas esperadas

• 201 Created o 200 OK: registro aceptado.
• 4xx/5xx: semántica de errores definida por el cliente (auth, validación, etc.).

Encabezados y seguridad

• Autenticación: Bearer/API Key/Mutual TLS (definido por el cliente).
• Transporte: HTTPS obligatorio en producción.
• Rate limiting y auditoría implementados por el cliente.

Responsabilidades

• El software no envía fotografía ni biométricos; solo datos alfanuméricos.
• El cliente define validación, almacenamiento, retención y accesos.
• Uso para procesos internos; no sustituye verificación oficial del RENAP.

Consulte: Características, Uso legal y Privacidad.