Verfügbare Uploads für die Registrierung auflisten

Verfügbare Upload-Referenzen auflisten

Verwenden Sie diesen Endpunkt nach dem Hochladen von Registrierungsdokumenten, wenn Sie Referenzen benötigen, die noch für eine Zuordnung verfügbar sind. Verwenden Sie ein freigeschaltetes MultiTEL-API-Konto über HTTPS mit den dafür konfigurierten Zugangsdaten und IP-Beschränkungen. Die Liste ist auf Ihr Konto beschränkt.

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

Es sind weder ein Anfrageinhalt noch Abfrageparameter erforderlich. Der Handler listet über die API erstellte Upload-Datensätze auf, deren Ablaufkennzeichen nicht gesetzt ist und deren Ablaufzeit nach der aktuellen Serverzeit liegt. Er bietet keine Parameter für Seitennavigation, Suche oder Sortierung. Dies ist keine Liste sämtlicher Identitäten, Nachweise oder früherer Dokumente Ihres Kontos.

Metadaten statt Dokumentdaten auslesen

Prüfen Sie das HTTP-Ergebnis und status.code in den JSON-Daten. Bei einer erfolgreichen Antwort enthält response ein Array; ein leeres Ergebnis ist ein leeres Array und kein Fehler wegen eines fehlenden Kontos. Das Beispiel verwendet fiktive Metadaten und Kennungen.

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

Metadatenfelder des Uploads
Feld	Bedeutung
`id`	Die externe Upload-Referenz. Übernehmen Sie sie unverändert in die entsprechende Zuordnungsanfrage. Berechnen Sie keine eigene Kennung und ersetzen Sie die Referenz nicht durch die ID einer Identität, Adresse oder Vorlage.
`proof_type`	Die maskierte gespeicherte Typreferenz, sofern vorhanden, andernfalls eine leere Zeichenfolge. Bei hochgeladenen Nachweisen ist dies der Nachweistyp; bei hochgeladenen ergänzenden Dokumenten wird unter demselben Schlüssel die Vorlagenreferenz gespeichert. Lesen Sie entity_type aus, um sie zu unterscheiden. Dies ist nicht die Upload-ID.
`entity_type`	Die gespeicherte Zuordnungskategorie, beispielsweise identities, addresses oder supporting_documents. Wählen Sie den dazu passenden Zuordnungsablauf.
`description`	Die gespeicherte Beschreibung des Uploads.
`file_name`	Der ursprüngliche Dateiname. Dies ist keine Download-URL.
`date`	Der gespeicherte Erstellungszeitpunkt, vom Server ohne Zeitzonenversatz formatiert.

Die Antwort enthält weder Dokumentdaten noch eine Speicher-URL oder einen Ablaufzeitpunkt. Bewahren Sie expired_at aus der ursprünglichen Upload-Antwort auf. Das Auflisten eines Uploads verlängert weder seine Gültigkeit noch ordnet es ihn einer Identität zu oder belegt, dass ein Netzbetreiber ihn genehmigt hat.

Vor Ablauf der Referenz zuordnen

Verwenden Sie den passenden Ablauf für die Zuordnung eines Nachweises oder die Zuordnung eines ergänzenden Dokuments. Beim aktuellen Upload-Ablauf sind Referenzen nur kurz gültig; schieben Sie die Zuordnung nicht allein deshalb auf, weil eine Referenz in dieser Liste erschienen ist. Eine Referenz kann zwischen dem Auflisten und der Zuordnung ablaufen oder nicht mehr verfügbar sein. Werten Sie die Antwort auf die Zuordnungsanfrage aus, statt von einem Erfolg auszugehen.

Falls die Liste unerwartet leer ist, prüfen Sie das Konto und ob der Upload abgelaufen ist oder über einen anderen Ablauf erstellt wurde. Laden Sie dieselben Dokumente nicht automatisch erneut hoch, ohne die Ergebnisse des ursprünglichen Uploads und der Zuordnung zu prüfen.

Datenschutz

Dateinamen und Beschreibungen können Personen oder Dokumente identifizierbar machen, auch wenn die Dateiinhalte fehlen. Beschränken Sie den Zugriff und vermeiden Sie es, vollständige Antworten zu protokollieren. Informationen zum Entfernen einer ungenutzten lokalen Upload-Referenz finden Sie unter Upload-Referenz entfernen; dieser Vorgang bietet keine umfassende Löschung von Dokumenten.