Gauti patvirtinamųjų dokumentų šablonų sąrašą

Naršykite šablonų katalogą

Norėdami gauti paslaugos grąžinamų šablonų sąrašą, praleiskite neprivalomą ISO kelio segmentą. Norėdami filtruoti sąrašą, nurodykite šalies ISO kodą. Filtras lygina orientacinę šablono šalies reikšmę, kuri gali būti nustatyta pagal pavadinimą ir gali būti tuščia.

Pasirinkite šabloną pagal reikalavimus

Tai, kad šablonas yra sąraše, nereiškia, kad jis privalomas ar priimamas kiekvienam tos šalies numeriui. Patikrinkite, ar šablono ID atitinka taikomus patvirtinamųjų dokumentų reikalavimus. Šis sąrašas negeneruoja, nepasirašo, neįkelia ir nepatvirtina užpildyto dokumento.

Jei negrąžinama jokių šablonų

Tuščias filtruotas sąrašas gali reikšti, kad nerasta atitinkančios orientacinės šalies reikšmės. Tuščias nefiltruotas sąrašas taip pat gali reikšti, kad pirminio duomenų šaltinio duomenys nepasiekiami. Nelaikykite nė vieno iš šių rezultatų įrodymu, kad patvirtinamasis dokumentas nereikalingas.

Prieš naudodami atsisiųstą kopiją, ją peržiūrėkite

Katalogo atsisiuntimo nuoroda gali pateikti kopiją su pakeistu formatavimu ar prekės ženklo elementais. Nemanykite, kad tai nepakeistas sutarties originalas arba kad ją atsisiuntus įvykdomas registracijos reikalavimas. Prieš pildydami ar pasirašydami bet kurį dokumentą, peržiūrėkite jo turinį.

Jei portalo dokumentų vedlys siūlo parengti sutartį, naudokitės jo peržiūros ir aiškaus pateikimo veiksmų seka. Prieš pildydami kitas privalomas formas, su MultiTEL pasitikslinkite, kuri forma šiuo metu galioja. Atsisiųstas šablonas nėra pasirašytas priedas, įkeltas patvirtinamasis dokumentas ar numerio patvirtinimas.

Užklausa

Naudokite savo įgalintos API paskyros prisijungimo duomenis per HTTPS. Palaikomas Basic autentifikavimas ir įgalinti API paskyros bearer prieigos raktai; taikomi paskyros apribojimai.

GET su bet kuriuo dokumentacijoje aprašytu parametru URL kelyje.

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

Kelio parametrai
Pavadinimas	Tipas	Privalomas	Aprašymas
`iso`	string	Ne	Neprivalomas šalies ISO filtras. Norėdami gauti nefiltruotą sąrašą, praleiskite visą šį kelio segmentą. Lyginant neatsižvelgiama į didžiąsias ir mažąsias raides. Jei reikšmės nežinomos arba neatitinka, grąžinamas tuščias sąrašas, o ne aiški netinkamos šalies klaida.

Atsakymas

Patikrinkite status.code JSON turinyje ir HTTP būseną. response yra objektų su laukais id, name, permanent, iso ir url masyvas. permanent tipas yra boolean; iso gali būti tuščias ir galėjo būti nustatytas pagal šablono pavadinimą. Informaciją apie šalį laikykite orientacine, o ne sprendimu dėl tinkamumo. Tuščias katalogas yra sėkmingas 200 atsakymas; jis taip pat gali būti grąžintas, kai paieška pirminiame duomenų šaltinyje neduoda duomenų. URL generuoja paslauga; jo serverio vardas gali skirtis nuo pateikto iliustraciniame pavyzdyje.

Iliustracinė atsakymo struktūra; tai nėra faktiniai paskyros duomenys ar šiuo metu galiojantis kainos pasiūlymas.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "TEMPLATE_ID_FROM_RESPONSE",
      "name": "Example supporting-document template",
      "permanent": false,
      "iso": "US",
      "url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
    }
  ]
}

Klaidos

Patikrinkite status.code ir status.msg, ar nėra autentifikavimo arba paslaugos klaidų. Sėkmingai grąžintas tuščias katalogas nėra dokumento patvirtinimas ar atleidimas nuo registracijos reikalavimo.

Prieinamumas ir šalutinis poveikis

Ši katalogo ir reikalavimų paieška nesukuria tapatybės, neįkelia patvirtinamojo dokumento, neregistruoja numerio ir nepateikia užsakymo.
Sėkmingas katalogo atsakymas nėra jūsų dokumentų patvirtinimas ar patvirtinimas, kad pasirinktą numerį galima aktyvinti.