Pregledajte katalog predložaka
Izostavite neobavezni segment putanje s ISO kodom kako biste dobili popis predložaka koje usluga vraća. Navedite ISO kod države kako biste filtrirali popis. Filtar provjerava podudaranje s naznakom države u predlošku, koja može biti izvedena iz naziva i može biti prazna.
Odaberite predložak prema zahtjevima
Prisutnost predloška ne znači da je on obavezan ili prihvatljiv za svaki broj u toj državi. Uskladite identifikator predloška s primjenjivim zahtjevima za popratne dokumente. Ovaj popis ne izrađuje, ne potpisuje, ne prenosi niti odobrava ispunjeni dokument.
Ako nije vraćen nijedan predložak
Prazan filtrirani popis može značiti da nije pronađena odgovarajuća naznaka države. Prazan nefiltrirani popis također može biti posljedica nedostupnosti podataka iz izvorišnog sustava. Nijedan od tih rezultata nemojte smatrati dokazom da popratni dokument nije potreban.
Pregledajte preuzetu kopiju prije upotrebe
Poveznica za preuzimanje iz kataloga može vratiti kopiju s izmijenjenim oblikovanjem ili oznakama robne marke. Nemojte pretpostaviti da je riječ o neizmijenjenom izvornom ugovoru ili da njegovo preuzimanje ispunjava neki zahtjev za registraciju. Pregledajte sadržaj prije ispunjavanja ili potpisivanja bilo kojeg dokumenta.
Ako čarobnjak za dokumente na portalu nudi pripremu ugovora, upotrijebite njegov pretpregled i postupak izričitog slanja. Za ostale obavezne obrasce prije ispunjavanja provjerite s MultiTEL-om koji je obrazac trenutačno važeći. Preuzeti predložak nije potpisani prilog, preneseni dokaz ni odobrenje broja.
Zahtjev
Upotrijebite vjerodajnice svojeg omogućenog API računa putem HTTPS-a. Podržani su autentifikacija Basic i omogućeni tokeni bearer API računa; primjenjuju se ograničenja računa.
GET s bilo kojim dokumentiranim parametrom u putanji URL-a.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"| Naziv | Vrsta | Obavezno | Opis |
|---|---|---|---|
iso | string | Ne | Neobavezni filtar prema ISO kodu države. Za nefiltrirani popis izostavite cijeli taj segment putanje. Usporedba ne razlikuje velika i mala slova. Nepoznate vrijednosti ili vrijednosti bez podudaranja vraćaju prazan popis umjesto izričite pogreške zbog nevaljane države. |
Odgovor
Provjerite status.code u tijelu JSON-a, kao i HTTP status. response je niz objekata s poljima id, name, permanent, iso i url. permanent je vrijednost vrste boolean; iso može biti prazan i može biti izveden iz naziva predloška. Podatke o državi smatrajte naznakom, a ne odlukom o ispunjavanju uvjeta. Prazan katalog uspješan je odgovor sa statusom 200 i može nastati i kada pretraživanje izvorišnog sustava ne vrati podatke. URL generira usluga; njegov naziv poslužitelja može se razlikovati od onoga u ilustrativnom primjeru.
Ilustrativna struktura odgovora; ne predstavlja podatke računa u stvarnom vremenu ni aktualnu ponudu.
{
"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"
}
]
}Pogreške
- Provjerite status.code i status.msg radi pogrešaka autentifikacije ili usluge. Uspješno vraćen prazan katalog ne predstavlja odobrenje dokumenta ni izuzeće od registracije.
Dostupnost i popratni učinci
- Ovo pretraživanje kataloga ili zahtjeva ne stvara identitet, ne prenosi dokaz, ne registrira broj niti šalje narudžbu.
- Uspješan odgovor kataloga ne predstavlja odobrenje vaših dokumenata ni potvrdu da se odabrani broj može aktivirati.