Sirvige mallikataloogi
Teenuse tagastatud mallide loendi saamiseks jätke valikuline ISO teelõik ära. Loendi filtreerimiseks sisestage riigi ISO-kood. Filter otsib vastet malli riigivihjega, mis võib olla tuletatud nimest ja võib olla tühi.
Valige mall nõuete alusel
Malli olemasolu ei tähenda, et see on nõutav või aktsepteeritav selle riigi iga numbri puhul. Viige malli ID vastavusse kohaldatavate tõendavate dokumentide nõuetega. See loend ei loo, allkirjasta, laadi üles ega kiida heaks täidetud dokumenti.
Kui ühtegi malli ei tagastata
Tühi filtreeritud loend võib tähendada, et sobivat riigivihjet ei leitud. Tühi filtreerimata loend võib tuleneda ka sellest, et ülesvoolu andmed pole kättesaadavad. Ärge käsitage kumbagi tulemust tõendina, et tõendavat dokumenti pole vaja.
Vaadake allalaaditud koopia enne kasutamist üle
Kataloogi allalaadimislink võib tagastada koopia, mille vormindust või brändielemente on muudetud. Ärge eeldage, et see on muutmata algne leping või et selle allalaadimine täidab registreerimisnõude. Vaadake sisu üle enne mis tahes dokumendi täitmist või allkirjastamist.
Kui portaali dokumendiviisard pakub lepingu ettevalmistamist, kasutage selle eelvaadet ja selgesõnalise esitamise töövoogu. Muude nõutavate vormide puhul kontrollige enne täitmist MultiTEL-iga, milline vorm on kehtiv. Allalaaditud mall ei ole allkirjastatud manus, üleslaaditud tõend ega numbri heakskiit.
Päring
Kasutage oma aktiveeritud API-konto autentimisandmeid HTTPS-i kaudu. Toetatud on Basic-autentimine ja aktiveeritud API-konto bearer-tõendid; kehtivad kontopiirangud.
GET, mille korral kõik dokumenteeritud parameetrid esitatakse URL-i tees.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"| Nimi | Tüüp | Nõutav | Kirjeldus |
|---|---|---|---|
iso | string | Ei | Valikuline riigi ISO-koodi filter. Filtreerimata loendi saamiseks jätke kogu see teelõik ära. Võrdlus ei erista suur- ja väiketähti. Tundmatute või vasteta väärtuste korral tagastatakse tühi loend, mitte selgesõnaline vigase riigi veateade. |
Vastus
Kontrollige JSON-i sisus välja status.code ja ka HTTP olekut. response on massiiv objektidest, mille väljad on id, name, permanent, iso ja url. permanent on tüüpi boolean; iso võib olla tühi ning võib olla tuletatud malli nimest. Käsitage riigiteavet vihjena, mitte sobivust kinnitava otsusena. Tühi kataloog on edukas vastus koodiga 200 ja võib tekkida ka siis, kui ülesvoolu päring ei anna andmeid. URL-i loob teenus; selle hostinimi võib erineda näites toodust.
Näitlik vastuse struktuur; see ei sisalda konto reaalajaandmeid ega kehtivat hinnapakkumist.
{
"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"
}
]
}Vead
- Autentimis- või teenusevigade tuvastamiseks kontrollige välju status.code ja status.msg. Eduka vastusena saadud tühi kataloog ei tähenda dokumendi heakskiitu ega registreerimisest vabastamist.
Kättesaadavus ja kõrvalmõjud
- See kataloogi või nõuete päring ei loo identiteeti, laadi üles tõendit, registreeri numbrit ega esita tellimust.
- Edukas kataloogivastus ei tähenda teie dokumentide heakskiitu ega kinnitust, et valitud numbri saab aktiveerida.