Last opp dokumentasjonsfiler for registrering

Last opp før du knytter til

Last opp filene for én kategori bevis eller støttedokumenter, og knytt deretter til de returnerte fil-ID-ene ved hjelp av create_proof eller create_supporting_document. Opplasting alene oppretter verken en identitet, en adresse, et bevis eller en fullført nummerregistrering. Ta utgangspunkt i gjeldende krav og ID-er fra katalogene.

Oppgi nøyaktig én valgparameter: proof_type_id for et identitets- eller adressebevis, eller supporting_template_id for et støttedokument. Ikke send begge. Bruk ID-er som returneres av den aktuelle MultiTEL-katalogen; behandle dem som ugjennomsiktige identifikatorer uten å tolke innholdet.

Opplastingsforespørsel

Bruk en aktivert MultiTEL API-konto og IP-adressen som er tillatt for kontoen. Eksemplene bruker påloggingsopplysninger for HTTP Basic fra miljøvariabler; følg autentiseringsreglene for kontotypen din. Send forespørsler over HTTPS. Kontroller både HTTP-svaret og følgende felt i JSON: status.code; applikasjonsfeil kan returneres med HTTP 200. Eksemplene 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

Felt i forespørselen
Felt	Betydning
`files[0] … files[4]`	Én til fem opplastede filer. Bruk flerdelte skjemadata og la curl generere grensemarkøren for Content-Type. Disse feltene inneholder filenes byte, ikke URL-er eller Base64 i JSON.
`proof_type_id`	Påkrevd ved opplasting av bevis; bruk en returnert ID for bevistype. Utelat supporting_template_id.
`supporting_template_id`	Påkrevd i stedet for proof_type_id for støttefiler; bruk en returnert mal-ID.
`description`	Valgfri beskrivelse oppgitt av den som sender forespørselen, på høyst 100 tegn. Ved opplasting av støttefiler kan malnavnet brukes når beskrivelsen er utelatt.

Filbegrensninger

Denne behandlingsfunksjonen godtar høyst fem filer og totalt 20,000,000 byte. Dette er en desimal bytegrense, ikke 20 MiB. Infrastruktur eller MIME-validering kan pålegge ytterligere begrensninger.

Listen over tillatte filendelser er pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf og csv. En tillatt filendelse fastslår ikke at filen oppfyller det valgte registreringskravet. Merk spesielt at tif ikke finnes på denne listen over tillatte filendelser.

Kontroller hver returnerte 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"
      }
    ]
  }
}

Ta vare på hver response.ids[].id til forespørselen om tilknytning. name angir det returnerte navnet på kildefilen. Bruk unike filnavn og sammenlign de returnerte filene med det forventede settet: kode 200 kan bety at en sats bare var delvis vellykket. Ikke knytt til et sett som mangler påkrevde filer.

entity_type er identities eller addresses for et bevis, og supporting_documents ved opplasting av støttefiler. document_category er proof eller supporting. Det generelt navngitte feltet proof_type i svaret inneholder også en malreferanse ved opplasting av støttefiler; behold den opprinnelige supporting_template_id til tilknytningen.

Knytt til filene raskt

Tjenesten setter utløpstiden til omtrent 20 minutter etter at opplastingen er lagret lokalt. Ved tilknytning kontrolleres det at filen tilhører samme konto, ikke er merket som utløpt, ennå ikke har nådd utløpstiden og har riktig enhetskategori. expired_at har ingen tidssoneforskyvning i dette svaret; ikke anta at tidspunktet er i UTC. Knytt til filene raskt fremfor å planlegge arbeidet helt ved utløpstiden.

At opplastingsreferansen utløper, er ingen garanti for at alle lagrede dokumentkopier slettes på det tidspunktet. Tjenesten krypterer filer for opplasting til operatøren og beholder kildebytene til dokumentarbeidsflyten; ikke betrakt dette som kryptering utelukkende på klienten eller som en tjeneste uten datalagring. Hold ID-er, filnavn og svar utenfor offentlige logger.

Feil og nye forsøk

Den nåværende behandlingsfunksjonen bruker API-kode 404 når ingen dokumentfiler er oppgitt, og kode 500 ved feil i valideringen av beskrivelsen, manglende eller motstridende valgparametere, ugyldige ID-er for bevistyper eller maler, overskridelse av grensen for antall filer eller samlet størrelse, lagringsproblemer eller en mislykket opplasting. Les status.msg; ugyldige inndata angis ikke konsekvent med kode 400.

Ingen idempotensnøkkel er tilgjengelig for klienten her. Hvis svaret går tapt, kontroller dokumentarbeidsflyten før du gjentar opplastingen; en ny forespørsel kan opprette nye filreferanser. Disse eksemplene er ikke kjørt med kundenes identitetsdokumenter.