Crearea unui profil de înregistrare

Creați profilul o singură dată

Această cerere creează un profil local de înregistrare împreună cu înregistrările de identitate și de adresă de la operator. Începeți cu informațiile actuale despre țările de înregistrare, tipurile de numere și cerințe. Cerințele depind de țară și de tipul de număr pe care intenționați să îl înregistrați.

Un răspuns de creare reușit nu reprezintă o aprobare de reglementare și nici activarea numărului. Salvați separat UUID-ul documentului, ID-ul de identitate și ID-ul de adresă: acestea au scopuri diferite. Această cerere modifică datele contului și nu este o operațiune exclusiv de validare.

Cererea de creare

Autentificați-vă cu contul MultiTEL API activat și cu adresa IP permisă a acestuia. Exemplele folosesc acreditări HTTP Basic stocate în variabile de mediu. Verificați atât răspunsul HTTP, cât și câmpul JSON status.code; un răspuns HTTP 200 nu demonstrează singur succesul. Toate valorile din exemple sunt fictive.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @registration-profile.json \
  https://api.multitel.net/v3/create_document

{
  "identity_type": "Personal",
  "first_name": "Example",
  "last_name": "Person",
  "phone_number": "12025550123",
  "email": "end-user@example.com",
  "city": "Example City",
  "postal_code": "00000",
  "country": "US",
  "address": "1 Example Street",
  "nationality": "US",
  "signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE"
}

Codul JSON este un profil Personal ilustrativ, nu o identitate reală gata de trimis. Înlocuiți detaliile și semnătura acestuia cu informațiile utilizatorului final cerute de regulile de înregistrare selectate. Este acceptată și intrarea codificată ca formular.

Câmpurile profilului de înregistrare
Câmp	Obligativitate și format
`identity_type`	Obligatoriu. Folosiți exact valoarea Personal sau Business; validarea condiționată depinde de scrierea cu majuscule.
`first_name, last_name`	Obligatorii, fiecare de cel mult 64 de caractere. Pentru o companie, furnizați datele reprezentantului cerute de țara selectată.
`phone_number`	Valoare telefonică numerică obligatorie, de cel puțin opt caractere. Un număr internațional format doar din cifre, inclusiv codul de țară, este potrivit pentru această validare; acesta este un număr de contact, nu o achiziție de număr.
`city, postal_code, address`	Obligatorii, fiecare de cel mult 64 de caractere.
`country`	Cod ISO obligatoriu al țării adresei, din catalogul de înregistrare. Serviciul îl asociază cu înregistrarea de țară a operatorului.
`signature`	Date de semnătură obligatorii. Portalul actual furnizează octeții imaginii PNG în Base64, fără prefixul data:image/png;base64,. Obțineți semnătura utilizatorului final prin fluxul dvs. de lucru autorizat; un substituent nevid nu este o semnătură valabilă.
`nationality`	Obligatoriu pentru Personal, sub forma unui cod ISO de țară. Nu înlocuiți cu un UUID de țară.
`company_name, incorporation_country`	Obligatorii pentru Business. Numele companiei are cel mult 64 de caractere; incorporation_country este un cod ISO de țară.
`email`	E-mail de contact opțional al utilizatorului final, de cel mult 254 de caractere. Un e-mail omis sau gol nu preia e-mailul contului de bază.
`company_reg_number, vat_id, id_number, personal_tax_id, birth_date, description`	Opționale în acest handler, însă țara/operatorul selectat poate cere unele dintre ele. Furnizați formatele cerute pentru înregistrarea respectivă. Apelurile API directe nu aplică automat toate normalizările efectuate de portal.

Acest handler direct v3 cere câmpurile de adresă și creează o adresă. Nu presupuneți că opțiunea portalului de amânare a adresei este disponibilă prin intermediul lui.

Păstrați toți cei trei identificatori

Mai jos sunt prezentate câmpuri selectate din răspuns; răspunsul real conține și informațiile de profil trimise și datele semnăturii. Tratați răspunsul complet ca fiind privat.

{
  "status": {
    "code": 200,
    "msg": "Success Create Registration Detail."
  },
  "response": {
    "uuid": "11111111111111111111111111111111",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "country_iso": "US",
    "email": "end-user@example.com"
  }
}

response.uuid identifică profilul local. Folosiți-l cu get_document. În răspunsurile documents și get_document, același identificator de profil se numește id.
response.identity_id identifică identitatea pentru trimiterea ulterioară de dovezi de identitate și documente justificative.
response.address_id identifică adresa creată. Păstrați-l separat; UUID-ul profilului local nu este un ID de adresă. Compatibilitatea atașării ulterioare a dovezilor de adresă pentru profilurile nou create este încă în curs de examinare.

Cele două puncte finale de citire a profilului nu returnează identity_id sau address_id, așa că păstrați răspunsul original de creare reușită. Dacă s-a pierdut, folosiți vizualizarea documentului din portal sau contactați asistența înainte de a crea un înlocuitor.

Avansat: atașarea dovezilor încărcate în prealabil în timpul creării

Puteți furniza identity_encryptfiles și address_encryptfiles ca matrice de ID-uri returnate de create_encrypt_files. Încărcați folosind un tip de dovadă pentru categoria de entitate corespunzătoare, apoi trimiteți înainte de expirarea referinței de fișier, de aproximativ 20 de minute. Handlerul de creare verifică contul, categoria și expirarea fiecărei referințe furnizate.

Aceste câmpuri au nume diferite de encrypted_file_ids din punctul final de atașare ulterior. În timpul creării, fiecare fișier este trimis ca o cerere de dovadă separată, chiar și atunci când mai multe fișiere au același tip de dovadă. Pentru o dovadă de identitate care trebuie să conțină mai multe fișiere împreună, folosiți cererea ulterioară create_proof cu o singură matrice. Crearea reușită a profilului nu oferă, singură, rezultate individuale de aprobare a dovezilor.

Dacă o dovadă de adresă ulterioară este respinsă pentru o adresă nou creată, nu înlocuiți cu UUID-ul profilului și nu recreați identitatea în mod repetat. Opriți-vă și verificați profilul în portal sau împreună cu asistența. Calea de citire/căutare a dovezilor de adresă rămâne o limitare a examinării.

Eșecuri și creare parțială

Codul API 400 acoperă validarea câmpurilor, eșecurile de creare la operator și eșecurile de salvare locală. Erorile de validare pot apărea ca intrări indexate după câmp în response. Codul 500 este folosit pentru o țară de înregistrare indisponibilă/nevalidă, iar codul 404 pentru referințe încărcate în prealabil lipsă sau expirate. Citiți status.msg împreună cu codul.

Profilul local și operațiunile operatorului din amonte nu formează o singură tranzacție atomică. O cerere eșuată poate lăsa o stare în amonte chiar și atunci când nu este listat niciun profil local. Nu este expusă nicio cheie de idempotență pentru client. După o expirare a timpului sau un eșec incert, inspectați profilurile existente și contactați asistența înainte de a repeta crearea; o listă documents goală nu este o dovadă că nu s-a creat nimic în amonte.