Laai bewyslêers vir registrasie op

Laai op voordat jy aanheg

Laai die lêers vir een kategorie van bewys of stawende dokument op en heg dan die teruggestuurde lêer-ID's aan met create_proof of create_supporting_document. Oplaai alleen skep nie 'n identiteit, 'n adres, 'n bewys of 'n voltooide nommerregistrasie nie. Begin met die huidige vereistes en katalogus-ID's.

Verskaf presies een keuseparameter: proof_type_id vir identiteits- of adresbewys, of supporting_template_id vir 'n stawende dokument. Moenie albei stuur nie. Gebruik ID's wat deur die toepaslike MultiTEL-katalogus teruggestuur word; behandel hulle as identifiseerders waarvan die interne struktuur geen betekenis vir jou het nie.

Oplaaiversoek

Gebruik 'n geaktiveerde MultiTEL API-rekening en die IP-adres wat daarvoor toegelaat word. Die voorbeelde gebruik HTTP Basic-aanmeldbesonderhede uit omgewingsveranderlikes; volg die verifikasiereëls vir jou rekeningtipe. Stuur versoeke oor HTTPS. Kontroleer sowel die HTTP-antwoord as die JSON-veld status.code; toepassingsfoute kan met HTTP 200 ontvang word. Die voorbeelde hieronder is fiktief.

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

Versoekvelde
Veld	Betekenis
`files[0] … files[4]`	Een tot vyf opgelaaide lêers. Gebruik meerdelige vormdata en laat curl die Content-Type-grens genereer. Hierdie velde bevat lêergrepe, nie URL's of JSON Base64 nie.
`proof_type_id`	Vereis wanneer bewyslêers opgelaai word; gebruik 'n teruggestuurde bewystipe-ID. Laat supporting_template_id weg.
`supporting_template_id`	Vereis in plaas van proof_type_id vir stawende lêers; gebruik 'n teruggestuurde sjabloon-ID.
`description`	Opsionele beskrywing wat deur die aanroeper verskaf word, hoogstens 100 karakters. Wanneer stawende lêers opgelaai word, kan die sjabloonnaam gebruik word as die beskrywing weggelaat word.

Lêerbeperkings

Hierdie verwerker aanvaar hoogstens vyf lêers en 'n totaal van 20,000,000 grepe. Dit is 'n desimale greepbeperking, nie 20 MiB nie. Infrastruktuur of MIME-validering kan bykomende beperkings oplê.

Die lys van toegelate uitbreidings is pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf en csv. 'n Toegelate uitbreiding bevestig nie dat 'n lêer aan die gekose registrasievereiste voldoen nie. Let veral daarop dat tif nie op hierdie lys van toegelate uitbreidings is nie.

Kontroleer elke teruggestuurde lêer

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

Bewaar elke response.ids[].id vir die aanhegversoek. name identifiseer die teruggestuurde bronlêernaam. Gebruik verskillende lêername en vergelyk die teruggestuurde lêers met die verwagte stel: kode 200 kan 'n gedeeltelik suksesvolle bondel aandui. Moenie 'n stel aanheg waarin vereiste lêers ontbreek nie.

entity_type is identities of addresses vir 'n bewys, en supporting_documents wanneer stawende lêers opgelaai word. document_category is proof of supporting. Die antwoordveld met die algemene naam proof_type bevat ook 'n sjabloonverwysing wanneer stawende lêers opgelaai word; bewaar jou oorspronklike supporting_template_id vir die aanhegting.

Heg spoedig aan

Die diens stel die vervaltyd op ongeveer 20 minute nadat die opgelaaide lêer plaaslik gestoor is. By aanhegting word gekontroleer dat die lêer aan dieselfde rekening behoort, nie as verval gemerk is nie, nog nie sy vervaltyd bereik het nie en die korrekte entiteitskategorie het. expired_at het geen tydsone-afset in hierdie antwoord nie; moenie aanvaar dat dit UTC is nie. Heg spoedig aan eerder as om werk vir die oomblik net voor verstryking te skeduleer.

Die verstryking van die oplaaiverwysing is nie 'n belofte dat alle gestoorde dokumentkopieë op daardie tydstip uitgevee word nie. Die diens enkripteer lêers vir oplaai na die telekommunikasie-operateur en bewaar die brongrepe vir die dokumentwerkvloei; moenie dit beskou as enkripsie slegs aan die kliëntkant of as 'n diens wat geen data bewaar nie. Hou ID's, lêername en antwoorde uit openbare logboeke.

Foute en herpogings

Die huidige verwerker gebruik API-kode 404 wanneer geen dokumentlêers verskaf word nie, en kode 500 vir foute met beskrywingsvalidering, ontbrekende of botsende keuseparameters, ongeldige bewystipe- of sjabloon-ID's, oorskryding van die lêertelling- of totale groottebeperking, bergingsprobleme of 'n onsuksesvolle oplaai. Lees status.msg; ongeldige invoer word nie deurgaans deur kode 400 aangedui nie.

Geen idempotensiesleutel vir die kliënt word hier beskikbaar gestel nie. As die antwoord verlore gaan, kontroleer die dokumentwerkvloei voordat jy weer oplaai; nog 'n versoek kan nuwe lêerverwysings skep. Hierdie voorbeelde is nie met kliënte se identiteitsdokumente uitgevoer nie.