Upload dokumentationsfiler til registrering

Upload før tilknytning

Upload filerne til én kategori af dokumentation eller supplerende dokumenter, og tilknyt derefter de returnerede fil-id'er med create_proof eller create_supporting_document. Upload alene opretter hverken en identitet, en adresse, dokumentation eller en fuldført nummerregistrering. Tag udgangspunkt i de aktuelle krav og katalog-id'er.

Angiv præcis én vælger: proof_type_id til dokumentation for identitet/adresse eller supporting_template_id til et supplerende dokument. Send ikke begge. Brug id'er returneret af det relevante MultiTEL-katalog; behandl dem som identifikatorer, hvis indhold ikke skal fortolkes.

Uploadanmodning

Brug en aktiveret MultiTEL API-konto og den IP-adresse, der er tilladt for kontoen. Eksemplerne bruger legitimationsoplysninger til HTTP Basic fra miljøvariabler; følg godkendelseskonventionerne for din kontotype. Send anmodninger via HTTPS. Kontrollér både HTTP-svaret og JSON-feltet status.code; applikationsfejl kan modtages med HTTP 200. Eksemplerne nedenfor er fiktive.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

Anmodningsfelter
Felt	Betydning
`files[0] … files[4]`	Én til fem uploadede filer. Brug formulardata i flere dele, og lad curl generere sin afgrænsning i Content-Type. Disse felter indeholder filernes byte, ikke URL'er eller JSON Base64.
`proof_type_id`	Påkrævet ved upload af dokumentation; brug et returneret id for dokumentationstype. Udelad supporting_template_id.
`supporting_template_id`	Påkrævet i stedet for proof_type_id til supplerende filer; brug et returneret skabelon-id.
`description`	Valgfri beskrivelse angivet af den kaldende part, højst 100 tegn. Ved upload af supplerende dokumentation kan skabelonnavnet bruges, hvis beskrivelsen udelades.

Filgrænser

Denne behandlingsfunktion accepterer højst fem filer og i alt 20,000,000 byte. Dette er en decimal bytegrænse, ikke 20 MiB. Infrastrukturen eller MIME-valideringen kan medføre yderligere begrænsninger.

De tilladte filendelser er pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf og csv. En tilladt filendelse er ikke i sig selv bevis for, at en fil opfylder det valgte registreringskrav. Bemærk især, at tif ikke er på denne liste over tilladte filendelser.

Kontrollér hver returneret fil

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

Gem hver response.ids[].id til tilknytningsanmodningen. name angiver det returnerede kildefilnavn. Brug forskellige filnavne, og sammenlign de returnerede filer med det forventede sæt: kode 200 kan dække over en kun delvist vellykket batch. Tilknyt ikke et sæt, der mangler påkrævede filer.

entity_type er identities eller addresses for dokumentation og supporting_documents ved upload af supplerende dokumentation. document_category er proof eller supporting. Det generisk navngivne felt proof_type i svaret indeholder også en skabelonreference ved upload af supplerende dokumentation; gem dit oprindelige supporting_template_id til tilknytningen.

Tilknyt hurtigst muligt

Tjenesten angiver et udløbstidspunkt cirka 20 minutter efter, at uploaden er gemt lokalt. Ved tilknytning kontrolleres det, at filen tilhører samme konto, ikke er markeret som udløbet, endnu ikke har nået sit udløbstidspunkt og har den korrekte entitetskategori. expired_at har ingen tidszoneforskydning i dette svar; antag ikke, at det er UTC. Tilknyt hurtigst muligt i stedet for at planlægge arbejdet lige ved udløbsgrænsen.

Uploadreferencens udløb er ikke et løfte om, at alle gemte dokumentkopier slettes på det tidspunkt. Tjenesten krypterer filer til upload til teleoperatøren og bevarer de oprindelige byte til dokumentarbejdsgangen; betragt ikke dette som kryptering udelukkende på klientsiden eller som en tjeneste uden dataopbevaring. Hold id'er, filnavne og svar ude af offentlige logfiler.

Fejl og gentagne forsøg

Den nuværende behandlingsfunktion bruger API-kode 404, når der ikke angives nogen dokumentfiler, og kode 500 ved validering af beskrivelsen, manglende eller modstridende vælgere, ugyldige dokumentations- eller skabelon-id'er, grænsen for filantal eller samlet størrelse, lagringsproblemer eller en mislykket upload. Læs status.msg; ugyldigt input angives ikke konsekvent med kode 400.

Her stilles ingen idempotensnøgle til rådighed for klienten. Hvis svaret går tabt, skal du kontrollere dokumentarbejdsgangen, før du gentager en upload; en ny anmodning kan oprette nye filreferencer. Disse eksempler er ikke blevet kørt med kunders identitetsdokumenter.