Încărcarea fișierelor justificative pentru înregistrare

Încărcați înainte de a atașa

Încărcați fișierele pentru o singură categorie de dovezi sau documente justificative, apoi atașați ID-urile fișierelor returnate folosind create_proof sau create_supporting_document. Simpla încărcare nu creează o identitate, o adresă, o dovadă și nici o înregistrare finalizată a numărului. Începeți cu cerințele în vigoare și cu ID-urile din catalog.

Furnizați exact un parametru de selecție: proof_type_id pentru o dovadă a identității/adresei sau supporting_template_id pentru un document justificativ. Nu îi trimiteți pe amândoi. Folosiți ID-urile returnate de catalogul MultiTEL corespunzător; tratați-le ca identificatori opaci.

Cererea de încărcare

Folosiți un cont API MultiTEL activat și adresa IP permisă pentru acesta. Exemplele folosesc date de autentificare HTTP Basic din variabile de mediu; respectați convențiile de autentificare pentru tipul contului dumneavoastră. Trimiteți cererile prin HTTPS. Verificați atât răspunsul HTTP, cât și câmpul JSON status.code; erorile aplicației pot fi returnate cu HTTP 200. Exemplele de mai jos sunt fictive.

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

Câmpurile cererii
Câmp	Semnificație
`files[0] … files[4]`	Între unul și cinci fișiere încărcate. Folosiți date de formular multipart și lăsați curl să genereze delimitatorul pentru Content-Type. Aceste câmpuri conțin octeții fișierelor, nu URL-uri sau date Base64 în JSON.
`proof_type_id`	Obligatoriu la încărcarea unei dovezi; folosiți un ID al tipului de dovadă returnat. Omiteți supporting_template_id.
`supporting_template_id`	Obligatoriu în loc de proof_type_id pentru fișierele justificative; folosiți un ID returnat, de tip ID de șablon.
`description`	Descriere opțională furnizată de apelant, de cel mult 100 de caractere. La încărcarea fișierelor justificative se poate folosi numele șablonului dacă descrierea este omisă.

Limitele fișierelor

Această rutină de procesare acceptă cel mult cinci fișiere și un total de 20,000,000 de octeți. Aceasta este o limită în octeți zecimali, nu de 20 MiB. Infrastructura sau validarea MIME poate impune limite suplimentare.

Lista extensiilor permise este pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf și csv. O extensie permisă nu dovedește că fișierul îndeplinește cerința de înregistrare selectată. În particular, tif nu se află pe această listă de extensii permise.

Verificați fiecare fișier returnat

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

Păstrați fiecare response.ids[].id pentru cererea de atașare. name identifică numele fișierului-sursă returnat. Folosiți nume de fișiere distincte și comparați fișierele returnate cu setul așteptat: codul 200 poate reprezenta un lot procesat cu succes doar parțial. Nu atașați un set din care lipsesc fișiere obligatorii.

entity_type are valoarea identities sau addresses pentru o dovadă și supporting_documents pentru o încărcare de fișiere justificative. document_category are valoarea proof sau supporting. Câmpul cu denumirea generică proof_type din răspuns conține și o referință la șablon pentru încărcările de fișiere justificative; păstrați valoarea inițială a supporting_template_id pentru atașare.

Atașați fără întârziere

Serviciul stabilește expirarea la aproximativ 20 de minute după stocarea locală a fișierului încărcat. La atașare se verifică dacă fișierul aparține aceluiași cont, nu este marcat ca expirat, nu a ajuns încă la termenul de expirare și are categoria de entitate corectă. expired_at nu include un decalaj de fus orar în acest răspuns; nu presupuneți că este în UTC. Atașați fără întârziere, în loc să programați operațiunea chiar la termenul-limită.

Expirarea referinței de încărcare nu reprezintă o promisiune că toate copiile stocate ale documentelor sunt șterse în acel moment. Serviciul criptează fișierele pentru încărcarea la operator și păstrează octeții-sursă pentru fluxul de procesare a documentelor; nu considerați că acesta oferă criptare exclusiv pe partea clientului sau un serviciu fără păstrarea datelor. Nu includeți ID-urile, numele fișierelor și răspunsurile în jurnale publice.

Erori și reîncercări

Rutina de procesare actuală folosește codul API 404 atunci când nu sunt furnizate fișiere de documente și codul 500 pentru validarea descrierii, parametri de selecție lipsă sau în conflict, ID-uri nevalide de tipuri de dovezi ori de șabloane, atingerea limitei privind numărul de fișiere sau dimensiunea totală, probleme de stocare ori o încărcare nereușită. Citiți status.msg; datele de intrare nevalide nu sunt reprezentate în mod consecvent prin codul 400.

Aici nu este pusă la dispoziție nicio cheie de idempotență pentru client. Dacă răspunsul se pierde, verificați fluxul de procesare a documentelor înainte de a repeta încărcarea; o altă cerere poate crea referințe noi la fișiere. Aceste exemple nu au fost executate cu documente de identitate ale clienților.