List opp maler for støttedokumentasjon

Bla gjennom malkatalogen

Utelat det valgfrie ISO-segmentet i URL-stien for å liste opp malene som tjenesten returnerer. Oppgi en ISO-landkode for å filtrere listen. Filteret sammenligner med malens indikasjon på land, som kan være utledet fra et navn og kan være tom.

Bruk kravene til å velge en mal

At en mal finnes i listen, betyr ikke at den er påkrevd eller godtas for alle numre i det aktuelle landet. Sammenhold mal-ID-en med de gjeldende kravene til støttedokumentasjon. Denne listen genererer, signerer, laster opp eller godkjenner ikke et ferdig utfylt dokument.

Hvis ingen maler returneres

En tom filtrert liste kan bety at ingen samsvarende indikasjon på land ble funnet. En tom ufiltrert liste kan også skyldes at data fra en oppstrømskilde er utilgjengelige. Ingen av resultatene må tolkes som bevis på at støttedokumentasjon ikke er påkrevd.

Gjennomgå en nedlastet kopi før du bruker den

En nedlastingslenke i katalogen kan returnere en kopi med endret formatering eller merkevareprofilering. Ikke anta at kopien er en uendret originalavtale, eller at nedlastingen oppfyller et registreringskrav. Gjennomgå innholdet før du fyller ut eller signerer noe dokument.

Når dokumentveiviseren i portalen tilbyr utarbeidelse av avtaler, bruker du forhåndsvisningen og arbeidsflyten der innsending skjer uttrykkelig. For andre påkrevde skjemaer må du få bekreftet gjeldende skjema hos MultiTEL før du fyller det ut. En nedlastet mal er ikke et signert vedlegg, et opplastet dokumentasjonsbevis eller en godkjenning av et nummer.

Forespørsel

Bruk påloggingsopplysningene for den aktiverte API-kontoen din over HTTPS. Autentisering med Basic og aktiverte bearer-tokener for API-kontoen støttes; kontobegrensninger gjelder.

GET med eventuell dokumentert parameter i URL-stien.

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

Stiparametere
Navn	Type	Påkrevd	Beskrivelse
`iso`	string	Nei	Valgfritt filter med ISO-landkode. Utelat hele dette stisegmentet for å få den ufiltrerte listen. Sammenligningen skiller ikke mellom store og små bokstaver. Ukjente verdier eller verdier uten treff returnerer en tom liste i stedet for en uttrykkelig feil om ugyldig land.

Svar

Kontroller status.code i JSON-innholdet i tillegg til HTTP-statusen. response er en liste med objekter med feltene id, name, permanent, iso og url. permanent er av typen boolean; iso kan være tom og kan ha blitt utledet fra malnavnet. Behandle landinformasjonen som en indikasjon, ikke som en avgjørelse om kvalifisering. En tom katalog er et vellykket svar med status 200 og kan også forekomme når oppslaget mot oppstrømskilden ikke gir noen data. URL-en genereres av tjenesten; vertsnavnet kan avvike fra det illustrerende eksemplet.

Illustrasjon av svarstrukturen; ikke faktiske kontodata eller et gjeldende pristilbud.

{
  "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"
    }
  ]
}

Feil

Kontroller status.code og status.msg for autentiseringsfeil eller tjenestefeil. En tom katalog i et vellykket svar er ikke en godkjenning av et dokument eller et fritak fra registrering.

Tilgjengelighet og sideeffekter

Dette oppslaget i katalogen eller kravene oppretter ikke en identitet, laster ikke opp dokumentasjonsbevis, registrerer ikke et nummer og legger ikke inn en bestilling.
Et vellykket katalogsvar er ikke en godkjenning av dokumentene dine eller en bekreftelse på at et valgt nummer kan aktiveres.