Choisir une référence de téléversement inutilisée
Ce point de terminaison supprime un enregistrement de référence de téléversement appartenant à votre compte. Utilisez-le uniquement lorsque vous avez la certitude que cette référence n’est plus nécessaire pour joindre un justificatif ou joindre un document complémentaire. Il ne supprime ni une identité ni une adresse d’enregistrement.
Récupérez l’identifiant externe du fichier dans la réponse initiale au téléversement ou dans la liste des téléversements disponibles. Le gestionnaire recherche d’abord cet identifiant pour votre compte, puis utilise en dernier recours l’ancien mécanisme de recherche par identifiant du fournisseur. Les nouvelles intégrations doivent utiliser la référence externe exactement telle qu’elle est renvoyée. Aucun corps de requête n’est requis.
Demander la suppression de manière délibérée
Utilisez un compte API MultiTEL activé via HTTPS, avec les identifiants et les restrictions d’adresses IP configurés pour ce compte. Utilisez POST afin que votre application traite cette opération comme une modification délibérée :
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefLe gestionnaire actuel n’impose aucune restriction sur la méthode HTTP : une requête GET peut également déclencher la suppression. N’exposez pas cette URL sous la forme d’un lien cliquable ordinaire, d’une image, d’un favori ou d’une cible d’aperçu ou de préchargement. Exigez une action explicite de suppression dans votre application et ne renouvelez pas automatiquement la tentative.
Interpréter le résultat et ses limites
Consultez à la fois le résultat HTTP et le champ status.code de la réponse JSON. La réponse habituelle en cas de succès est la suivante :
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Le code API 404 accompagné de Failed, Not found signifie qu’aucune des deux recherches n’a trouvé de référence correspondante pour ce compte. Une nouvelle tentative de suppression peut donc renvoyer 404. Les espaces au début et à la fin de la valeur dans le chemin sont supprimés. Aucun contrôle ne vérifie ici que la référence n’a pas expiré ou qu’elle n’est pas utilisée par une autre étape ; vérifiez donc votre processus avant de la supprimer.
Le gestionnaire signale un succès après avoir tenté la suppression dans la base de données, sans vérifier si cette suppression a réussi. Considérez la réponse comme le résultat annoncé, et non comme une preuve indépendante d’effacement. Si une référence non expirée créée via l’API était visible dans get_encrypted_files, cette liste peut aider à vérifier si elle est toujours visible ; toutefois, son absence de la liste peut aussi signifier qu’elle a expiré.
La suppression ne constitue pas un effacement complet des données
Le gestionnaire émet une commande de suppression dans la table des références de téléversement. Il ne supprime pas explicitement la ligne contenant le contenu du document stocké, le fichier téléversé localement, le justificatif joint, l’identité, le document complémentaire ou la copie détenue par le fournisseur. Le comportement des suppressions en cascade dans la base de données et de la conservation des données n’a pas été vérifié. Ne présentez pas cette opération aux utilisateurs comme supprimant toutes les copies de leur document d’identité ou comme répondant à une demande d’effacement intégral.
Une fois la référence locale supprimée, les étapes ultérieures de rattachement qui en ont besoin peuvent échouer. Conservez les résultats des rattachements déjà effectués et utilisez le processus approprié de gestion des identités ou des justificatifs pour modifier les informations d’enregistrement déjà soumises.