Skip to Content
Inicio rápido

Inicio rápido

1. Obtén tu API key

Cada institución cliente recibe una API key propia. Contáctanos a sales@valteh.com si todavía no tienes una.

Al solicitar tu API key, indícanos qué modalidad de servicio necesitas:

  • Validación con extracción de datos — corre los verificadores y además regresa los campos extraídos del documento (extracted_data).
  • Solo validación — únicamente el veredicto y los checks de fraude.
  • Solo extracción de datos — únicamente los campos extraídos, sin correr los verificadores.

Esto determina cómo se configura tu institución del lado de SAREMI.

Tu API key es un secreto. No la incluyas en código de frontend ni en repositorios públicos.

2. Elige tu protocolo

  • Si tu backend puede hacer requests HTTP con multipart/form-data, usa la API REST.
  • Si integras desde una plataforma de bajo código (como QuickBase o similares), usa la API SOAP.

3. Haz tu primera verificación (REST)

terminal
curl -X POST https://api.saremi.io/v1/verify/document \
  -H "X-API-Key: TU_API_KEY" \
  -F "file=@ine_frontal.jpg"

Esto envía el documento al endpoint de verificación automática: SAREMI detecta el tipo de documento (INE en este caso) y corre los verificadores correspondientes.

4. Lee la respuesta

{
  "document_type": "ine",
  "status": "verified",
  "confidence_score": 0.925,
  "conclusion": "Documento verificado correctamente...",
  "processing_time_ms": 18432,
  "checks": [
    { "name": "curp_format", "status": "passed", "detail": "..." }
  ],
  "extracted_data": {
    "full_name": "JUAN PÉREZ LÓPEZ",
    "curp": "PELJ800101HDFRPN09"
  },
  "warnings": [],
  "fraud_flags": []
}

status es el veredicto final. Ver el detalle completo del modelo de respuesta en API REST y los posibles valores en Errores y estados.

Siguientes pasos

Last updated on
IntroducciónAutenticación y permisos