Utvecklare

GET/v3/get_encrypted_files

Lista tillgängliga uppladdningar för registrering

Hitta uppladdningsreferenser från API:et som inte har löpt ut och tillhörande metadata innan du bifogar registreringshandlingar.

På denna sida
  1. Lista tillgängliga uppladdningsreferenser
  2. Läs metadata, inte dokumentets byte
  3. Bifoga dokumentet innan referensen löper ut
  4. Integritet

Lista tillgängliga uppladdningsreferenser

Använd denna ändpunkt efter uppladdning av registreringshandlingar när du behöver hitta referenser som fortfarande kan användas för att bifoga dokument. Använd ett aktiverat MultiTEL-API-konto via HTTPS med kontots konfigurerade inloggningsuppgifter och IP-begränsningar. Listan omfattar endast ditt konto.

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

Ingen begärandekropp eller några frågeparametrar krävs. Hanteraren listar uppladdningsposter som skapats via API, vars flagga för utgången giltighet inte är satt och vars giltighetstid löper ut efter serverns aktuella tid. Den tillhandahåller inga parametrar för sidindelning, sökning eller sortering. Detta är inte en lista över alla identiteter, intyg eller historiska dokument på ditt konto.

Läs metadata, inte dokumentets byte

Läs HTTP-resultatet och fältet status.code i JSON-svaret. Ett lyckat svar innehåller en array i response; ett tomt resultat är en tom array, inte ett fel som anger att kontot saknas. Exemplet använder fiktiva metadata och identifierare.

{
  "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"
  }]
}
Metadatafält för uppladdningar
FältBetydelse
idDen externa uppladdningsreferensen. Kopiera den exakt till den aktuella begäran om att bifoga dokumentet. Beräkna inte en identifierare själv och ersätt den inte med ett ID för en identitet, en adress eller en mall.
proof_typeDen maskerade, registrerade typreferensen om den finns, annars en tom sträng. För uppladdade intyg är detta intygstypen; för uppladdade kompletterande dokument registreras mallreferensen under samma nyckel. Läs entity_type för att skilja dem åt. Detta är inte uppladdningens ID.
entity_typeDen registrerade kategorin för det som ska bifogas, till exempel identities, addresses eller supporting_documents. Välj motsvarande arbetsflöde för att bifoga dokumentet.
descriptionDen lagrade beskrivningen av uppladdningen.
file_nameDet ursprungliga filnamnet. Detta är inte en nedladdningsadress.
dateDen registrerade tidpunkten då uppladdningen skapades, formaterad av servern utan tidszonsförskjutning.

Svaret innehåller inga dokumentbyte, någon lagringsadress eller någon tidpunkt då giltigheten löper ut. Spara expired_at från det ursprungliga uppladdningssvaret. Att en uppladdning listas förlänger inte dess giltighet, kopplar den inte till en identitet och bevisar inte att en operatör har godkänt den.

Bifoga dokumentet innan referensen löper ut

Använd lämpligt arbetsflöde för att bifoga intyg eller att bifoga kompletterande dokument. Det nuvarande uppladdningsflödet ger referenser en kort giltighetstid; vänta inte med att bifoga dokumentet bara för att en referens visades i denna lista. En referens kan löpa ut eller bli otillgänglig mellan listningen och det att dokumentet bifogas. Hantera svaret på begäran om att bifoga dokumentet i stället för att anta att åtgärden lyckades.

Om listan oväntat är tom, kontrollera kontot och om uppladdningens giltighet har löpt ut eller om den skapades via ett annat arbetsflöde. Ladda inte automatiskt upp samma dokument igen utan att kontrollera resultaten från den ursprungliga uppladdningen och begäran om att bifoga dokumentet.

Integritet

Filnamn och beskrivningar kan identifiera personer eller dokument även när filinnehållet saknas. Begränsa åtkomsten och undvik att logga hela svar. För att ta bort en oanvänd lokal uppladdningsreferens, se ta bort en uppladdningsreferens; den åtgärden är inte en heltäckande tjänst för radering av dokument.