Selaa malliluetteloa
Jätä valinnainen ISO-polkuosa pois, jos haluat luetella palvelun palauttamat mallit. Suodata luettelo antamalla maan ISO-koodi. Suodatus perustuu mallin suuntaa antavaan maatietoon, joka voidaan päätellä nimestä ja joka voi olla tyhjä.
Valitse malli vaatimusten perusteella
Mallin sisältyminen luetteloon ei tarkoita, että sitä vaaditaan tai että se hyväksytään maan kaikille numeroille. Vertaa mallin tunnusta sovellettaviin tukiasiakirjavaatimuksiin. Tämä luettelo ei luo, allekirjoita, lähetä palveluun eikä hyväksy täytettyä asiakirjaa.
Jos malleja ei palauteta
Tyhjä suodatettu luettelo voi tarkoittaa, ettei vastaavaa suuntaa antavaa maatietoa löytynyt. Tyhjä suodattamaton luettelo voi myös johtua siitä, ettei taustapalvelun tietoja ole saatavilla. Älä pidä kumpaakaan tulosta todisteena siitä, ettei tukiasiakirjaa tarvita.
Tarkista ladattu kopio ennen sen käyttöä
Luettelon latauslinkki voi palauttaa kopion, jonka muotoilua tai brändi-ilmettä on muutettu. Älä oleta, että kyseessä on muuttamaton alkuperäinen sopimus tai että sen lataaminen täyttää rekisteröintivaatimuksen. Tarkista sisältö ennen minkään asiakirjan täyttämistä tai allekirjoittamista.
Jos portaalin ohjattu asiakirjatoiminto tarjoaa sopimuksen laatimistoiminnon, käytä sen esikatselua ja työnkulkua, jossa lähettäminen vahvistetaan erikseen. Varmista muiden vaadittujen lomakkeiden ajantasaisuus MultiTELiltä ennen niiden täyttämistä. Ladattu malli ei ole allekirjoitettu liite, palveluun lähetetty tosite eikä numeron hyväksyntä.
Pyyntö
Käytä käytössä olevan API-tilisi tunnuksia HTTPS-yhteydellä. Basic-todennusta ja käytössä olevia API-tilin bearer-tunnisteita tuetaan; tilin rajoitukset ovat voimassa.
GET-pyyntö, jossa mahdollinen dokumentoitu parametri annetaan URL-polussa.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
iso | string | Ei | Valinnainen maan ISO-koodiin perustuva suodatin. Jätä tämä polkuosa kokonaan pois, jos haluat suodattamattoman luettelon. Vertailussa ei erotella isoja ja pieniä kirjaimia. Tuntemattomat arvot tai arvot, joille ei löydy vastinetta, palauttavat tyhjän luettelon erillisen virheellisestä maasta ilmoittavan virheen sijaan. |
Vastaus
Tarkista JSON-rungon status.code sekä HTTP-tilakoodi. response on taulukko olioita, jotka sisältävät kentät id, name, permanent, iso ja url. permanent on tyyppiä boolean; iso voi olla tyhjä, ja se on saatettu päätellä mallin nimestä. Käsittele maatietoa suuntaa antavana tietona, älä kelpoisuuspäätöksenä. Tyhjä luettelo on onnistunut 200-vastaus, ja se voi syntyä myös silloin, kun taustapalvelun haku ei palauta tietoja. Palvelu luo URL-osoitteen; sen isäntänimi voi poiketa havainnollistavasta esimerkistä.
Havainnollistava vastauksen rakenne; ei reaaliaikaisia tilitietoja eikä ajantasainen hintatarjous.
{
"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"
}
]
}Virheet
- Tarkista todennus- tai palveluvirheet kentistä status.code ja status.msg. Onnistuneesti palautettu tyhjä luettelo ei tarkoita asiakirjan hyväksyntää eikä vapautusta rekisteröinnistä.
Saatavuus ja sivuvaikutukset
- Tämä luettelo- ja vaatimushaku ei luo henkilöllisyyttä, lähetä tositetta palveluun, rekisteröi numeroa eikä tee tilausta.
- Onnistunut luettelovastaus ei tarkoita asiakirjojesi hyväksyntää eikä vahvistusta siitä, että valittu numero voidaan aktivoida.