Lister les documents téléversés disponibles pour l’enregistrement

Lister les références de téléversement disponibles

Utilisez ce point de terminaison après avoir téléversé les documents d’enregistrement lorsque vous devez rechercher des références encore utilisables pour joindre des documents. Utilisez un compte API MultiTEL activé via HTTPS, avec ses identifiants et ses restrictions d’adresses IP configurés. La liste est limitée à votre compte.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/get_encrypted_files

Aucun corps de requête ni paramètre de requête n’est requis. Le gestionnaire liste les enregistrements de téléversement créés via l’API dont l’indicateur d’expiration n’est pas activé et dont la date d’expiration est postérieure à l’heure actuelle du serveur. Il ne propose aucun paramètre de pagination, de recherche ou de tri. Il ne s’agit pas d’une liste de toutes les identités, de tous les justificatifs ou de tous les documents historiques de votre compte.

Consulter les métadonnées, et non les octets des documents

Consultez le résultat HTTP et le champ status.code du contenu JSON. Une réponse réussie contient un tableau dans response ; un résultat vide correspond à un tableau vide, et non à une erreur de compte introuvable. L’exemple utilise des métadonnées et des identifiants fictifs.

{
  "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"
  }]
}

Champs des métadonnées de téléversement
Champ	Signification
`id`	La référence externe du téléversement. Copiez-la exactement dans la demande de rattachement correspondante. Ne calculez pas vous-même un identifiant et ne la remplacez pas par un identifiant d’identité, d’adresse ou de modèle.
`proof_type`	La référence masquée du type enregistré, lorsqu’elle est présente ; sinon, une chaîne vide. Pour les téléversements de justificatifs, il s’agit du type de justificatif ; les téléversements de documents complémentaires enregistrent leur référence de modèle sous cette même clé. Consultez entity_type pour les distinguer. Il ne s’agit pas de l’identifiant du téléversement.
`entity_type`	La catégorie de rattachement enregistrée, par exemple identities, addresses ou supporting_documents. Choisissez le processus de rattachement correspondant.
`description`	La description enregistrée du téléversement.
`file_name`	Le nom d’origine du fichier. Il ne s’agit pas d’une adresse de téléchargement.
`date`	La date et l’heure de création enregistrées, mises en forme par le serveur sans décalage de fuseau horaire.

La réponse ne contient ni octets des documents, ni adresse de stockage, ni échéance d’expiration. Conservez expired_at provenant de la réponse initiale au téléversement. Le fait qu’un téléversement figure dans la liste ne prolonge pas sa validité, ne le rattache pas à une identité et ne prouve pas qu’un opérateur l’a approuvé.

Joindre le document avant l’expiration de la référence

Utilisez le processus approprié de rattachement d’un justificatif ou de rattachement d’un document complémentaire. Le processus actuel de téléversement accorde aux références une courte durée de validité ; ne retardez pas le rattachement au seul motif qu’une référence figure dans cette liste. Une référence peut expirer ou devenir indisponible entre la consultation de la liste et le rattachement. Traitez la réponse au rattachement au lieu de présumer sa réussite.

Si la liste est vide de manière inattendue, vérifiez le compte et déterminez si le téléversement a expiré ou s’il a été créé par un autre processus. Ne téléversez pas automatiquement les mêmes documents à nouveau sans vérifier les résultats du téléversement initial et du rattachement.

Confidentialité

Les noms de fichiers et les descriptions peuvent permettre d’identifier des personnes ou des documents même en l’absence du contenu des fichiers. Limitez l’accès et évitez de consigner les réponses complètes dans les journaux. Pour supprimer une référence locale de téléversement inutilisée, consultez supprimer une référence de téléversement ; cette opération ne constitue pas un service d’effacement intégral des documents.