Cargue los archivos antes de adjuntarlos
Cargue los archivos de una sola categoría de justificante o documento complementario y después adjunte los ID de archivo devueltos mediante create_proof o create_supporting_document. La carga por sí sola no crea una identidad, un domicilio ni un justificante, ni completa el registro de un número. Comience por los requisitos vigentes y los ID del catálogo.
Proporcione exactamente un selector: proof_type_id para un justificante de identidad o domicilio, o supporting_template_id para un documento complementario. No envíe ambos. Utilice los ID devueltos por el catálogo de MultiTEL correspondiente; trátelos como identificadores opacos.
Solicitud de carga
Utilice una cuenta habilitada de la API de MultiTEL y su dirección IP autorizada. Los ejemplos utilizan credenciales de autenticación básica HTTP procedentes de variables de entorno; siga las convenciones de autenticación de su tipo de cuenta. Envíe las solicitudes mediante HTTPS. Compruebe tanto la respuesta HTTP como el campo JSON status.code; los errores de la aplicación pueden llegar con HTTP 200. Los ejemplos siguientes son ficticios.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--form-string "proof_type_id=$PROOF_TYPE_ID" \
--form-string 'description=Identity proof' \
--form 'files[0]=@./identity-proof.pdf' \
https://api.multitel.net/v3/create_encrypt_files| Campo | Significado |
|---|---|
files[0] … files[4] | De uno a cinco archivos cargados. Utilice datos de formulario multiparte y deje que curl genere el delimitador de Content-Type. Estos campos contienen los bytes de los archivos, no URL ni datos Base64 en JSON. |
proof_type_id | Obligatorio para cargar un justificante; utilice un ID de tipo de justificante devuelto. Omita supporting_template_id. |
supporting_template_id | Obligatorio en lugar de proof_type_id para archivos complementarios; utilice un ID de plantilla devuelto. |
description | Descripción opcional proporcionada por quien realiza la llamada, de un máximo de 100 caracteres. Una carga de documentación complementaria puede utilizar el nombre de la plantilla cuando se omite la descripción. |
Límites de los archivos
Este controlador acepta como máximo cinco archivos y 20,000,000 bytes en total. Se trata de un límite de bytes decimal, no de 20 MiB. La infraestructura o la validación MIME pueden imponer límites adicionales.
La lista de extensiones permitidas es pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf y csv. Que una extensión esté permitida no demuestra que el archivo cumpla el requisito de registro seleccionado. En particular, tif no figura en esta lista de extensiones permitidas.
Compruebe cada archivo devuelto
{
"status": {
"code": 200,
"msg": "Encrypt file has been created successfully"
},
"response": {
"entity_type": "identities",
"document_category": "proof",
"proof_type": "11111111111111111111111111111111",
"ids": [
{
"id": "22222222222222222222222222222222",
"name": "identity-proof.pdf",
"expired_at": "2026-10-23 16:20:00"
}
]
}
}Conserve cada response.ids[].id para la solicitud de adjuntar archivos. name identifica el nombre del archivo de origen devuelto. Utilice nombres de archivo distintos y compare los archivos devueltos con el conjunto esperado: un código 200 puede representar un lote procesado con éxito parcial. No adjunte un conjunto al que le falten archivos obligatorios.
entity_type es identities o addresses para un justificante, y supporting_documents para una carga de documentación complementaria. document_category es proof o supporting. El campo de respuesta con el nombre genérico proof_type también contiene una referencia a una plantilla para las cargas de documentación complementaria; conserve su supporting_template_id original para adjuntar los archivos.
Adjunte los archivos cuanto antes
El servicio fija el vencimiento aproximadamente 20 minutos después de almacenar localmente la carga. Al adjuntar el archivo, se comprueba que pertenezca a la misma cuenta, que no esté marcado como vencido, que aún no haya llegado su vencimiento y que tenga la categoría de entidad correcta. expired_at no incluye un desplazamiento de zona horaria en esta respuesta; no dé por hecho que está en UTC. Adjunte los archivos cuanto antes en lugar de programar la operación para el momento límite.
El vencimiento de la referencia de carga no garantiza que todas las copias almacenadas de los documentos se eliminen en ese momento. El servicio cifra los archivos para cargarlos al operador y conserva los bytes originales para el flujo de gestión documental; no lo considere un cifrado exclusivo del cliente ni un servicio sin retención de datos. No incluya ID, nombres de archivo ni respuestas en registros públicos.
Errores y reintentos
El controlador actual utiliza el código de API 404 cuando no se proporcionan archivos de documentos, y el código 500 para la validación de la descripción, los selectores ausentes o en conflicto, los ID de justificante o plantilla no válidos, el límite de cantidad de archivos o de tamaño total, los problemas de almacenamiento o una carga fallida. Lea status.msg; los datos de entrada no válidos no siempre se representan con el código 400.
Aquí no se ofrece ninguna clave de idempotencia del cliente. Si se pierde la respuesta, compruebe el flujo de gestión documental antes de repetir una carga; otra solicitud puede crear nuevas referencias de archivo. Estos ejemplos no se han ejecutado con documentos de identidad de clientes.