Beschikbare uploads van registratiedocumenten opvragen

Beschikbare uploadverwijzingen opvragen

Gebruik dit eindpunt na het uploaden van registratiedocumenten wanneer u verwijzingen zoekt die nog beschikbaar zijn om te koppelen. Gebruik een ingeschakeld MultiTEL API-account via HTTPS met de daarvoor ingestelde inloggegevens en IP-beperkingen. De lijst is beperkt tot uw account.

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

Een aanvraaginhoud of queryparameters zijn niet vereist. De verwerkingsfunctie geeft uploadrecords terug die via de API zijn aangemaakt, waarvan de vervalvlag niet is ingesteld en waarvan het vervaltijdstip later ligt dan de huidige servertijd. Er zijn geen parameters voor paginering, zoeken of sorteren beschikbaar. Dit is geen lijst van alle identiteiten, bewijsstukken of historische documenten in uw account.

Metadata lezen, geen documentinhoud

Controleer het HTTP-resultaat en status.code in de JSON. Een geslaagd antwoord bevat een array in response; een leeg resultaat is een lege array, geen foutmelding over een ontbrekend account. Het voorbeeld gebruikt fictieve metadata en identificatoren.

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

Metadatavelden van uploads
Veld	Betekenis
`id`	De externe uploadverwijzing. Neem deze exact over in de bijbehorende aanvraag om een document te koppelen. Bereken zelf geen identificator en gebruik in plaats hiervan geen ID van een identiteit, adres of sjabloon.
`proof_type`	De gemaskeerde, opgeslagen typeverwijzing indien aanwezig, anders een lege tekenreeks. Bij uploads van bewijsstukken is dit het bewijstype; bij uploads van aanvullende documenten wordt de sjabloonverwijzing onder dezelfde sleutel opgeslagen. Lees entity_type om het onderscheid te maken. Dit is niet het upload-ID.
`entity_type`	De opgeslagen koppelingscategorie, zoals identities, addresses of supporting_documents. Kies de bijbehorende procedure om het document te koppelen.
`description`	De opgeslagen beschrijving van de upload.
`file_name`	De oorspronkelijke bestandsnaam. Dit is geen download-URL.
`date`	Het opgeslagen aanmaaktijdstip, door de server opgemaakt zonder vermelding van een tijdzone-offset.

Het antwoord bevat geen documentinhoud, opslag-URL of vervaltijdstip. Bewaar expired_at uit het oorspronkelijke uploadantwoord. Het opnemen van een upload in de lijst verlengt de geldigheid niet, koppelt de upload niet aan een identiteit en bewijst niet dat een telecomaanbieder deze heeft goedgekeurd.

Koppel het document voordat de verwijzing vervalt

Volg de passende procedure voor het koppelen van een bewijsstuk of het koppelen van een aanvullend document. Bij de huidige uploadprocedure zijn verwijzingen slechts kort geldig; stel het koppelen niet uit alleen omdat een verwijzing in deze lijst staat. Een verwijzing kan tussen het opvragen van de lijst en het koppelen vervallen of niet meer beschikbaar zijn. Verwerk het antwoord op de koppelingsaanvraag in plaats van aan te nemen dat deze is geslaagd.

Als de lijst onverwacht leeg is, controleer dan het account en ga na of de upload is vervallen of via een andere procedure is aangemaakt. Upload dezelfde documenten niet automatisch opnieuw zonder de resultaten van de oorspronkelijke upload en koppeling te controleren.

Persoonsgegevens beschermen

Bestandsnamen en beschrijvingen kunnen personen of documenten identificeren, ook als de bestandsinhoud ontbreekt. Beperk de toegang en vermijd het vastleggen van volledige antwoorden in logboeken. Zie voor het verwijderen van een ongebruikte lokale uploadverwijzing een uploadverwijzing verwijderen; die bewerking is geen dienst voor het volledig wissen van documenten.