Consultar las referencias de carga disponibles
Utilice este punto de acceso después de cargar documentos de registro cuando necesite encontrar referencias que sigan disponibles para adjuntar documentos. Utilice una cuenta habilitada de la API de MultiTEL a través de HTTPS, con sus credenciales y restricciones de IP configuradas. La lista se limita a su cuenta.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesNo se requiere un cuerpo de solicitud ni parámetros de consulta. El manejador enumera los registros de cargas creadas mediante la API cuyo indicador de caducidad no está activado y cuya fecha y hora de caducidad son posteriores a la fecha y hora actuales del servidor. No ofrece parámetros de paginación, búsqueda ni ordenación. No es una lista de todas las identidades, justificantes o documentos históricos de su cuenta.
Consultar los metadatos, no los bytes del documento
Consulte el resultado HTTP y el campo status.code del JSON. Una respuesta correcta contiene un arreglo en response; un resultado vacío es un arreglo vacío, no un error de cuenta inexistente. El ejemplo utiliza metadatos e identificadores ficticios.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| Campo | Significado |
|---|---|
id | La referencia externa de la carga. Cópiela exactamente en la solicitud correspondiente para adjuntar el documento. No calcule un identificador por su cuenta ni utilice en su lugar un identificador de identidad, dirección o plantilla. |
proof_type | La referencia enmascarada del tipo registrado, si existe; de lo contrario, una cadena vacía. Para las cargas de justificantes, corresponde al tipo de justificante; las cargas de documentos complementarios registran la referencia de su plantilla en esta misma clave. Consulte entity_type para distinguirlas. No es el identificador de la carga. |
entity_type | La categoría registrada para adjuntar el documento, como identities, addresses o supporting_documents. Elija el flujo correspondiente para adjuntarlo. |
description | La descripción almacenada de la carga. |
file_name | El nombre original del archivo. No es una URL de descarga. |
date | La fecha y hora de creación registradas, con el formato del servidor y sin indicación del desfase horario. |
La respuesta no contiene los bytes del documento, una URL de almacenamiento ni la fecha y hora de caducidad. Conserve expired_at de la respuesta original de la carga. Que una carga aparezca en la lista no amplía su validez, no la adjunta a una identidad ni demuestra que un operador de telecomunicaciones la haya aprobado.
Adjuntar antes de que caduque la referencia
Utilice el flujo de adjuntar justificantes o adjuntar documentos complementarios que corresponda. El flujo de carga actual otorga a las referencias un período de validez breve; no retrase la operación de adjuntar el documento solo porque una referencia haya aparecido en esta lista. Una referencia puede caducar o dejar de estar disponible entre la consulta de la lista y el momento de adjuntar el documento. Procese la respuesta de la operación de adjuntar en lugar de dar por hecho que se ha completado correctamente.
Si la lista está vacía de forma inesperada, compruebe la cuenta y si la carga ha caducado o se creó mediante otro flujo. No vuelva a cargar automáticamente los mismos documentos sin comprobar los resultados originales de la carga y de la operación de adjuntar.
Privacidad
Los nombres de archivo y las descripciones pueden identificar a personas o documentos aunque no se incluya el contenido de los archivos. Limite el acceso y evite registrar respuestas completas en los registros del sistema. Para eliminar una referencia local de carga que no se utilice, consulte eliminar una referencia de carga; esa operación no es un servicio de eliminación integral de documentos.