{
  "country": "mx",
  "tag": "some-tag-for-my-user",
  "items": [
    {
      "type": "generic"
    }
  ]
}
{
    "id": "vf_12345abcde",
    "status": "pending",
    "items": [
        {
            "id": "it_abcde12345",
            "type": "generic",
            "status": "pending",
            "options": {
                "upload_url": "https://s3-upload-url.trebol.com/some-presigned-url"
            }
        }
    ]
}
Este flujo te permite crear una verificación sin proporcionar una file_url al inicio. En su lugar, Trébol te dará una URL para que subas el documento directamente. Este método es útil si los documentos se generan dinámicamente o se encuentran en un almacenamiento privado. El proceso consta de tres pasos:
  1. Crear la verificación: Envías la solicitud inicial a Trébol para registrar la verificación y recibir una URL de carga.
  2. Subir el documento: Usas la URL proporcionada para subir tu archivo de forma segura.
  3. Confirmar la carga: Notificas a Trébol que el archivo está listo para ser procesado.

Paso 1: Crear la Verificación

Para iniciar el proceso, crea una verificación enviando los items que necesites procesar, pero sin incluir la opción file_url. Endpoint: POST /verifications
{
  "country": "mx",
  "tag": "some-tag-for-my-user",
  "items": [
    {
      "type": "generic"
    }
  ]
}
Trébol responderá con un verification_id y una lista de items, cada uno con su propio id y una upload_url única. El id del item es crucial para los siguientes pasos.
{
    "id": "vf_12345abcde",
    "status": "pending",
    "items": [
        {
            "id": "it_abcde12345",
            "type": "generic",
            "status": "pending",
            "options": {
                "upload_url": "https://s3-upload-url.trebol.com/some-presigned-url"
            }
        }
    ]
}

Paso 2: Subir el Documento

Con la upload_url recibida, sube el documento correspondiente mediante una solicitud PUT.
La upload_url es de un solo uso y expira después de 5 minutos.
Endpoint: PUT a la upload_url del item. Headers:
  • Content-Type: El tipo MIME del archivo (ej. application/pdf, image/jpeg).
Body: El contenido binario del archivo.
curl -X PUT "https://s3-upload-url.trebol.com/some-presigned-url" \
-H "Content-Type: application/pdf" \
--data-binary @"/ruta/a/tu/documento.pdf"
Una carga exitosa devolverá un código de estado 200 OK.

Paso 3: Confirmar y Procesar el Archivo

Una vez que el archivo se ha subido, debes notificar a Trébol que el documento está listo para ser procesado. Esto se hace enviando una solicitud PUT al endpoint del item específico, usando su id. Endpoint: PUT /verification-items/{item_id}
El item_id para este endpoint es el id del item que recibiste en la respuesta del Paso 1.
Body:
{
  "options": {
    "uploaded_file": true
  }
}
Después de este paso, el estado del item cambiará y Trébol comenzará el proceso de extracción de datos. Debes repetir los pasos 2 y 3 para cada item que requiera una carga manual.