Listează tipurile de numere pentru înregistrare

Alege un tip după denumirea returnată

Folosește o țară din get_document_countries. Transmite denumirea tipului returnat către get_requirements. Un ID de tip din catalog nu este un ID de prefix, un ID de număr sau un ID de categorie de documente justificative.

Numărul de grupuri nu reprezintă stocul de numere

available_groups indică numărul înregistrărilor de grup returnate de această interogare a catalogului. Nu numără numerele de telefon care pot fi achiziționate, nu rezervă stoc și nu garantează că au fost parcurse toate paginile din sursa din amonte a catalogului. Caută în stocul de numere relevant și examinează separat o ofertă de preț.

Cerere

Folosește prin HTTPS datele de autentificare ale contului tău API activat. Sunt acceptate autentificarea Basic și tokenurile bearer pentru contul API, dacă sunt activate; se aplică restricțiile contului.

GET cu orice parametru documentat inclus în calea URL-ului.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"

Răspuns

Verifică status.code din corpul JSON, precum și starea HTTP. response este un tablou care conține id, name și available_groups. Folosește name ca number_type când apelezi get_requirements; nu trimite id în locul său. available_groups reprezintă numărul înregistrărilor de grup returnate pentru acel tip, nu numărul de numere de telefon din stoc sau totalul complet al tuturor paginilor. Tipurile pentru care nu sunt returnate grupuri sunt omise. Ordinea preferată este Local, Mobile, National, Toll Free, Shared Cost, Global, urmate de celelalte denumiri din catalog.

Structură ilustrativă a răspunsului; nu reprezintă date în timp real ale contului sau o ofertă de preț actuală.

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

Erori

• 400: country is required: furnizează codul ISO al țării pentru înregistrare.
• 400: Invalid country ISO or no available DID registration country found: selectează o țară din catalogul actual de înregistrare; acest lucru nu dovedește că nu sunt necesare documente.

Disponibilitate și efecte secundare

• Această interogare a catalogului sau a cerințelor nu creează o identitate, nu încarcă un document justificativ, nu înregistrează un număr și nu plasează o comandă.
• Un răspuns reușit al catalogului nu reprezintă aprobarea documentelor tale sau confirmarea că un număr selectat poate fi activat.