Utvecklare

GET/v3/get_supporting_document_templates/{iso}

Lista mallar för styrkande dokument

Hitta mallarnas ID:n, namn och landsindikationer innan du förbereder ett styrkande dokument.

På denna sida
  1. Bläddra i mallkatalogen
  2. Välj en mall utifrån kraven
  3. Om inga mallar returneras
  4. Granska en nedladdad kopia innan du använder den
  5. Begäran
  6. Svar
  7. Fel
  8. Tillgänglighet och sidoeffekter

Bläddra i mallkatalogen

Utelämna det valfria ISO-segmentet i sökvägen för att lista de mallar som tjänsten returnerar. Ange en ISO-landskod för att filtrera listan. Filtret matchar mallens landsindikation, som kan ha härletts från ett namn och kan vara tom.

Välj en mall utifrån kraven

Att en mall finns med betyder inte att den krävs eller godtas för alla nummer i det landet. Matcha mallens ID mot de tillämpliga kraven på styrkande dokument. Den här listan genererar, undertecknar, laddar upp eller godkänner inte ett färdigställt dokument.

Om inga mallar returneras

En tom filtrerad lista kan betyda att ingen matchande landsindikation hittades. En tom ofiltrerad lista kan också bero på att data från den bakomliggande datakällan inte är tillgängliga. Betrakta inget av resultaten som bevis för att styrkande dokument inte krävs.

Granska en nedladdad kopia innan du använder den

En nedladdningslänk i katalogen kan returnera en kopia med ändrad formatering eller varumärkesprofilering. Utgå inte från att det är ett oförändrat originalavtal eller att nedladdningen uppfyller ett registreringskrav. Granska innehållet innan du fyller i eller undertecknar något dokument.

När portalens dokumentguide erbjuder förberedelse av avtal ska du använda guidens förhandsgranskning och arbetsflöde för uttrycklig inlämning. För andra obligatoriska blanketter ska du kontrollera med MultiTEL vilken blankett som gäller innan du fyller i den. En nedladdad mall är inte en undertecknad bilaga, ett uppladdat intyg eller ett godkännande av ett nummer.

Begäran

Använd inloggningsuppgifterna för ditt aktiverade API-konto över HTTPS. Autentisering med Basic och aktiverade bearer-token för API-konton stöds; kontobegränsningar gäller.

GET med eventuell dokumenterad parameter i URL-sökvägen.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"
Sökvägsparametrar
NamnTypObligatoriskBeskrivning
isostringNejValfritt filter för ISO-landskod. Utelämna hela detta sökvägssegment för att få den ofiltrerade listan. Jämförelsen skiljer inte mellan stora och små bokstäver. Okända värden eller värden utan matchning returnerar en tom lista i stället för ett uttryckligt fel om ogiltigt land.

Svar

Kontrollera status.code i JSON-kroppen och även HTTP-statusen. response är en array med objekt som innehåller id, name, permanent, iso och url. permanent är av typen boolean; iso kan vara tomt och kan ha härletts från mallens namn. Betrakta landsinformationen som en indikation, inte som ett beslut om huruvida kraven är uppfyllda. En tom katalog är ett lyckat svar med status 200 och kan också förekomma när uppslagningen i den bakomliggande datakällan inte ger några data. URL:en genereras av tjänsten; dess värdnamn kan skilja sig från det illustrativa exemplet.

Illustrativ svarsstruktur; inte aktuella kontodata eller en aktuell offert.

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

Fel

  • Kontrollera status.code och status.msg för autentiseringsfel eller tjänstefel. Ett lyckat svar med en tom katalog innebär inte att ett dokument har godkänts eller att undantag från registrering har beviljats.

Tillgänglighet och sidoeffekter

  • Den här uppslagningen av katalogen eller kraven skapar inte någon identitet, laddar inte upp något intyg, registrerar inte något nummer och lägger inte någon beställning.
  • Ett lyckat katalogsvar innebär inte att dina dokument har godkänts eller att det har bekräftats att ett valt nummer kan aktiveras.