Elija una referencia de carga sin utilizar
Este punto de acceso elimina un registro de referencia de carga que pertenece a su cuenta. Úselo únicamente cuando tenga la certeza de que la referencia ya no se necesita para la vinculación de un comprobante o la vinculación de un documento justificativo. No elimina una identidad ni una dirección del registro.
Obtenga el identificador externo del archivo de la fuente original, ya sea la respuesta de carga o la lista de cargas disponibles. El controlador busca primero ese identificador para su cuenta y, si no lo encuentra, recurre al identificador del proveedor del sistema anterior. Las nuevas integraciones deben usar la referencia externa exactamente como se devuelve. No se requiere un cuerpo de solicitud.
Solicite la eliminación de forma deliberada
Utilice una cuenta habilitada de la API de MultiTEL a través de HTTPS, con las credenciales y restricciones de IP configuradas para ella. Utilice POST para que su aplicación trate esta operación como un cambio deliberado:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefEl controlador actual no impone ninguna restricción sobre el método HTTP: una solicitud GET también puede provocar la eliminación. No exponga esta URL como un enlace normal en el que se pueda hacer clic, una imagen, un marcador ni un destino de vista previa o de obtención anticipada. Exija una acción explícita de eliminación en su aplicación y no reintente la operación automáticamente.
Interprete el resultado y sus limitaciones
Lea tanto el resultado HTTP como el campo status.code del JSON. La respuesta habitual en caso de éxito es:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}El código 404 de la API con Failed, Not found significa que ninguna de las dos búsquedas encontró una referencia coincidente para esta cuenta. Por lo tanto, repetir la eliminación puede devolver 404. Se eliminan los espacios al principio y al final del valor de la ruta. Aquí no se comprueba que la referencia no haya caducado ni que no se esté utilizando en otro paso, así que confirme su flujo de trabajo antes de eliminarla.
El controlador informa de que la operación se ha realizado correctamente después de intentar la eliminación en la base de datos, sin comprobar si esa eliminación se ha completado. Considere la respuesta como el resultado comunicado, no como una prueba independiente del borrado. Si una referencia creada mediante la API y aún no caducada aparecía en get_encrypted_files, esa lista puede ayudar a comprobar si sigue apareciendo, pero su ausencia de la lista también puede deberse a que haya caducado.
La eliminación no supone un borrado completo de los datos
El controlador ejecuta una operación de eliminación en la tabla de referencias de carga. No elimina explícitamente la fila que almacena el contenido del documento, el archivo cargado localmente, el comprobante adjunto, la identidad, el documento justificativo ni la copia en poder del proveedor. No se ha verificado el comportamiento de las operaciones en cascada de la base de datos ni de la conservación de datos. No presente esta operación a los usuarios como una eliminación de todas las copias de su documento de identidad ni como el cumplimiento de una solicitud de borrado integral.
Una vez eliminada la referencia local, pueden fallar los pasos posteriores de vinculación que la necesiten. Conserve los resultados de las vinculaciones ya completadas y utilice el flujo de trabajo de gestión de identidades o comprobantes que corresponda al modificar la información de registro enviada.