Izstrādātājiem

GET/v3/get_document_number_types/{country}

Iegūt reģistrācijai paredzēto numuru tipu sarakstu

Atrodiet numuru tipu nosaukumus, kas pašlaik ir iekļauti attiecīgās valsts reģistrācijas katalogā.

Šajā lapā
  1. Izvēlieties tipu pēc atgrieztā nosaukuma
  2. Grupu skaits nav pieejamo numuru krājums
  3. Pieprasījums
  4. Atbilde
  5. Kļūdas
  6. Pieejamība un blakusefekti

Izvēlieties tipu pēc atgrieztā nosaukuma

Izmantojiet valsti no get_document_countries. Nododiet atgriezto tipa nosaukumu funkcijai get_requirements. Tipa kataloga ID nav prefiksa ID, numura ID vai apliecinošo dokumentu kategorijas ID.

Grupu skaits nav pieejamo numuru krājums

available_groups norāda šajā kataloga vaicājumā atgriezto grupu ierakstu skaitu. Tas nenorāda iegādei pieejamo tālruņa numuru skaitu, nerezervē numuru krājumu un negarantē, ka katalogs ir izgājis visas augšupējā datu avota lapas. Atsevišķi meklējiet attiecīgajā pieejamo numuru krājumā un izskatiet cenas piedāvājumu.

Pieprasījums

Izmantojiet sava iespējotā API konta piekļuves datus, veidojot savienojumu ar HTTPS. Tiek atbalstīta Basic autentifikācija un iespējotā API konta bearer pilnvaras; ir spēkā konta ierobežojumi.

GET ar jebkuru dokumentēto parametru URL ceļā.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"
Ceļa parametri
NosaukumsTipsObligātsApraksts
countrystringJāValsts divu burtu ISO kods no reģistrācijai pieejamo valstu kataloga. Tam tiek noņemtas atstarpes sākumā un beigās, un burti tiek pārveidoti par lielajiem burtiem.

Atbilde

Pārbaudiet status.code JSON atbildes pamatdaļā, kā arī HTTP statusu. response ir masīvs, kas satur id, name un available_groups. Izmantojiet name kā number_type vērtību, izsaucot get_requirements; nesūtiet id tā vietā. available_groups ir attiecīgajam tipam atgriezto grupu ierakstu skaits, nevis pieejamo tālruņa numuru skaits vai kopējais ierakstu skaits visās lapās. Tipi, kuriem nav atgriezta neviena grupa, netiek iekļauti. Vēlamā secība ir Local, Mobile, National, Toll Free, Shared Cost, Global, kam seko pārējie kataloga nosaukumi.

Atbildes struktūras piemērs; tie nav aktuālie konta dati vai pašreizējais cenas piedāvājums.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

Kļūdas

  • 400: country is required: norādiet reģistrācijai pieejamās valsts ISO kodu.
  • 400: Invalid country ISO or no available DID registration country found: izvēlieties valsti no pašreizējā reģistrācijas kataloga; tas nenozīmē, ka dokumenti nav nepieciešami.

Pieejamība un blakusefekti

  • Šis kataloga vai prasību vaicājums neizveido identitāti, neaugšupielādē apliecinošu dokumentu, nereģistrē numuru un neveic pasūtījumu.
  • Veiksmīga kataloga atbilde nav jūsu dokumentu apstiprinājums vai apliecinājums, ka izvēlēto numuru var aktivizēt.