Utviklere

GET/v3/get_encrypted_files

List opp tilgjengelige registreringsopplastinger

Finn API-referanser til opplastinger som ikke har utløpt, og tilhørende metadata før du knytter til registreringsdokumenter.

På denne siden
  1. List opp tilgjengelige opplastingsreferanser
  2. Les metadata, ikke dokumentinnhold
  3. Knytt til filen før referansen utløper
  4. Personvern

List opp tilgjengelige opplastingsreferanser

Bruk dette endepunktet etter opplasting av registreringsdokumenter når du trenger å finne referanser som fortsatt kan brukes til å knytte til filer. Bruk en aktivert MultiTEL API-konto over HTTPS med kontoens konfigurerte påloggingsopplysninger og IP-begrensninger. Listen er avgrenset til kontoen din.

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

Det kreves verken forespørselskropp eller spørringsparametere. Behandlingsrutinen lister opp opplastingsposter opprettet via API der utløpsflagget ikke er satt, og der utløpstidspunktet er senere enn serverens nåværende tidspunkt. Den tilbyr ingen parametere for sideinndeling, søk eller sortering. Dette er ikke en liste over alle identiteter, bevisdokumenter eller historiske dokumenter på kontoen din.

Les metadata, ikke dokumentinnhold

Les HTTP-resultatet og status.code i JSON-svaret. Et vellykket svar inneholder en tabell i response; et tomt resultat er en tom tabell, ikke en feil om at kontoen mangler. Eksemplet bruker fiktive metadata og identifikatorer.

{
  "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"
  }]
}
Metadatafelter for opplastinger
FeltBetydning
idDen eksterne opplastingsreferansen. Kopier den nøyaktig til den aktuelle forespørselen om tilknytning. Ikke beregn en identifikator selv eller erstatt den med en identifikator for en identitet, adresse eller mal.
proof_typeDen maskerte, registrerte typereferansen hvis den finnes, ellers en tom streng. For opplastede bevisdokumenter er dette bevistypen; ved opplasting av støttedokumenter registreres malreferansen under den samme nøkkelen. Les entity_type for å skille dem fra hverandre. Dette er ikke opplastingens identifikator.
entity_typeDen registrerte tilknytningskategorien, for eksempel identities, addresses eller supporting_documents. Velg den tilsvarende arbeidsflyten for tilknytning.
descriptionDen lagrede beskrivelsen av opplastingen.
file_nameDet opprinnelige filnavnet. Dette er ikke en nedlastingsadresse.
dateDet registrerte opprettelsestidspunktet, formatert av serveren uten tidssoneforskyvning.

Svaret inneholder verken dokumentinnhold, lagringsadresse eller utløpstidspunkt. Ta vare på expired_at fra det opprinnelige opplastingssvaret. At en opplasting vises i listen, forlenger ikke gyldigheten, knytter den ikke til en identitet og beviser ikke at en operatør har godkjent den.

Knytt til filen før referansen utløper

Bruk den aktuelle arbeidsflyten for tilknytning av bevisdokumenter eller tilknytning av støttedokumenter. Den nåværende opplastingsflyten gir referanser kort gyldighetstid; ikke utsett tilknytningen bare fordi en referanse dukket opp i denne listen. En referanse kan utløpe eller bli utilgjengelig mellom oppføringen i listen og tilknytningen. Behandle svaret på tilknytningen fremfor å anta at den lyktes.

Hvis listen uventet er tom, kontroller kontoen og om opplastingen har utløpt eller ble opprettet gjennom en annen arbeidsflyt. Ikke last opp de samme dokumentene automatisk på nytt uten å kontrollere resultatene fra den opprinnelige opplastingen og tilknytningen.

Personvern

Filnavn og beskrivelser kan identifisere personer eller dokumenter selv om filinnholdet ikke er med. Begrens tilgangen og unngå å logge hele svar. For å fjerne en ubrukt lokal opplastingsreferanse, se fjerne en opplastingsreferanse; denne operasjonen er ikke en tjeneste for fullstendig sletting av dokumenter.