Lista nummertyper för registrering

Välj en typ med hjälp av namnet som returneras

Använd ett land från get_document_countries. Skicka det returnerade typnamnet till get_requirements. Ett ID i typkatalogen är inte ett prefix-ID, nummer-ID eller ID för en intygskategori.

Antalet grupper anger inte antalet tillgängliga nummer

available_groups räknar de grupposter som returneras av denna katalogsökning. Det räknar inte telefonnummer som kan köpas, reserverar inga nummer och garanterar inte att katalogen har hämtat alla sidor från den bakomliggande datakällan. Sök separat bland de relevanta tillgängliga numren och granska en offert.

Begäran

Använd inloggningsuppgifterna för ditt aktiverade API-konto via 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_document_number_types/$COUNTRY_ISO"

Svar

Kontrollera status.code i JSON-kroppen samt HTTP-statusen. response är en array som innehåller id, name och available_groups. Använd name som number_type när du anropar get_requirements; skicka inte id i dess ställe. available_groups är antalet grupposter som returneras för den typen, inte antalet tillgängliga telefonnummer eller en fullständig totalsumma över alla sidor. Typer för vilka inga grupper returneras utelämnas. Den föredragna ordningen är Local, Mobile, National, Toll Free, Shared Cost, Global, följt av övriga katalognamn.

Exempel på svarsstruktur; inte kontodata i realtid eller en aktuell offert.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

Fel

• 400: country is required: ange ISO-koden för registreringslandet.
• 400: Invalid country ISO or no available DID registration country found: välj ett land från den aktuella registreringskatalogen; detta innebär inte att inga dokument krävs.

Tillgänglighet och sidoeffekter

• Denna sökning i katalogen eller bland kraven skapar ingen identitet, laddar inte upp något intyg, registrerar inget nummer och lägger ingen beställning.
• Ett lyckat katalogsvar innebär inte att dina dokument har godkänts eller att det är bekräftat att ett valt nummer kan aktiveras.