Kreiranje registracionog profila

Kreirajte profil samo jednom

Ovaj zahtev kreira lokalni registracioni profil zajedno sa zapisima identiteta i adrese kod operatera. Počnite sa aktuelnim zemljama za registraciju, tipovima brojeva i zahtevima. Zahtevi zavise od zemlje i tipa broja koji planirate da registrujete.

Uspešan odgovor na kreiranje nije regulatorno odobrenje niti aktivacija broja. Sačuvajte UUID dokumenta, ID identiteta i ID adrese odvojeno: oni služe različitim svrhama. Ovaj zahtev menja podatke naloga i nije operacija koja služi samo za validaciju.

Zahtev za kreiranje

Autentifikujte se svojim omogućenim MultiTEL API nalogom i njegovom dozvoljenom IP adresom. Primeri koriste HTTP Basic kredencijale sačuvane u promenljivama okruženja. Proverite i HTTP odgovor i JSON status.code; sam HTTP 200 odgovor ne potvrđuje uspeh. Sve vrednosti u primerima su izmišljene.

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

JSON je ilustrativni Personal profil, a ne pravi identitet spreman za podnošenje. Zamenite njegove podatke i potpis informacijama o krajnjem korisniku koje zahtevaju izabrana pravila registracije. Podržan je i unos kodiran kao formular.

Polja registracionog profila
Polje	Obaveznost i format
`identity_type`	Obavezno. Koristite tačnu vrednost Personal ili Business; uslovna validacija zavisi od velikih i malih slova.
`first_name, last_name`	Obavezno, svako najviše 64 znaka. Za preduzeće navedite podatke o predstavniku koje zahteva izabrana zemlja.
`phone_number`	Obavezna numerička telefonska vrednost, najmanje osam znakova. Međunarodni broj koji sadrži samo cifre, uključujući pozivni broj zemlje, odgovara ovoj validaciji; ovo je kontakt broj, a ne kupovina broja.
`city, postal_code, address`	Obavezno, svako najviše 64 znaka.
`country`	Obavezan ISO kod zemlje adrese iz registracionog kataloga. Servis ga prevodi u zapis zemlje kod operatera.
`signature`	Obavezni podaci potpisa. Trenutni portal šalje bajtove Base64 PNG slike bez prefiksa data:image/png;base64,. Pribavite potpis krajnjeg korisnika kroz svoj ovlašćeni tok rada; neprazan rezervisani tekst nije smislen potpis.
`nationality`	Obavezno za Personal, kao ISO kod zemlje. Nemojte umesto toga navoditi UUID zemlje.
`company_name, incorporation_country`	Obavezno za Business. Naziv kompanije ima najviše 64 znaka; incorporation_country je ISO kod zemlje.
`email`	Opciona kontakt e-adresa krajnjeg korisnika, najviše 254 znaka. Izostavljena ili prazna e-adresa ne nasleđuje e-adresu osnovnog naloga.
`company_reg_number, vat_id, id_number, personal_tax_id, birth_date, description`	Opciono u ovom obrađivaču, ali izabrana zemlja/operater može zahtevati neka od njih. Navedite formate koje ta registracija zahteva. Direktni API pozivi ne primenjuju automatski svaku normalizaciju koju obavlja portal.

Ovaj direktni v3 obrađivač zahteva polja adrese i kreira adresu. Nemojte pretpostavljati da je opcija portala za odlaganje adrese dostupna kroz njega.

Sačuvajte sva tri identifikatora

U nastavku su prikazana izabrana polja odgovora; stvarni odgovor sadrži i poslate podatke profila i podatke potpisa. Ceo odgovor tretirajte kao privatan.

{
  "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 identifikuje lokalni profil. Koristite ga sa get_document. U odgovorima documents i get_document isti identifikator profila nosi naziv id.
response.identity_id identifikuje identitet za kasnije dokaze identiteta i prateće dokumente.
response.address_id identifikuje kreiranu adresu. Čuvajte ga odvojeno; UUID lokalnog profila nije ID adrese. Kasnija kompatibilnost prilaganja dokaza adrese za novokreirane profile je i dalje u fazi pregleda.

Dve krajnje tačke za čitanje profila ne vraćaju identity_id ni address_id, pa zato sačuvajte originalni uspešan odgovor na kreiranje. Ako je izgubljen, koristite prikaz dokumenata na portalu ili kontaktirajte podršku pre kreiranja zamene.

Napredno: prilaganje unapred otpremljenih dokaza tokom kreiranja

Možete navesti identity_encryptfiles i address_encryptfiles kao nizove ID-jeva koje vraća create_encrypt_files. Otpremite koristeći tip dokaza za odgovarajuću kategoriju entiteta, a zatim podnesite pre isteka reference na datoteku, koji nastupa posle otprilike 20 minuta. Obrađivač za kreiranje proverava nalog, kategoriju i istek svake navedene reference.

Ova polja imaju drugačije nazive od polja encrypted_file_ids kasnije krajnje tačke za prilaganje. Tokom kreiranja svaka datoteka se šalje kao zaseban zahtev za dokaz, čak i kada više datoteka deli isti tip dokaza. Za dokaz identiteta koji mora da sadrži više datoteka zajedno koristite kasniji zahtev create_proof sa jednim nizom. Samo uspešno kreiranje profila ne daje rezultate odobrenja pojedinačnih dokaza.

Ako je kasniji dokaz adrese odbijen za novokreiranu adresu, nemojte umesto toga navoditi UUID profila niti iznova kreirati identitet. Zaustavite se i proverite profil na portalu ili sa podrškom. Putanja za čitanje/pretragu dokaza adrese ostaje ograničenje pregleda.

Neuspesi i delimično kreiranje

API kod 400 pokriva validaciju polja, neuspehe kreiranja kod operatera i neuspehe lokalnog čuvanja. Greške validacije mogu se pojaviti kao stavke označene nazivom polja u response. Kod 500 se koristi za nedostupnu/nevažeću zemlju registracije, a kod 404 za nedostajuće ili istekle unapred otpremljene reference. Pročitajte status.msg kao i sam kod.

Lokalni profil i operacije kod uzvodnog operatera nisu jedna atomska transakcija. Neuspešan zahtev može ostaviti stanje kod operatera čak i kada nijedan lokalni profil nije prikazan u listi. Klijentski ključ idempotentnosti nije izložen. Posle isteka vremena ili neizvesnog neuspeha pregledajte postojeće profile i kontaktirajte podršku pre ponavljanja kreiranja; prazna documents lista nije dokaz da ništa nije kreirano kod operatera.