Vælg en type ud fra det returnerede navn
Brug et land fra get_document_countries. Send det returnerede typenavn til get_requirements. Et type-id i kataloget er ikke et præfiks-id, nummer-id eller id for en dokumentationskategori.
Antallet af grupper er ikke en nummerbeholdning
available_groups tæller de gruppeposter, som dette katalogopslag returnerer. Det tæller ikke telefonnumre, der kan købes, reserverer ikke numre fra beholdningen og garanterer ikke, at kataloget har hentet alle sider fra den bagvedliggende kilde. Søg i den relevante nummerbeholdning, og gennemgå et pristilbud separat.
Anmodning
Brug legitimationsoplysningerne til din aktiverede API-konto via HTTPS. Basic-autentificering og aktiverede bearer-tokens til API-kontoen understøttes; kontoens begrænsninger gælder.
GET med eventuelle dokumenterede parametre i URL-stien.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
country | string | Ja | Landets ISO-kode på to bogstaver fra kataloget over registreringslande. Indledende og afsluttende blanktegn fjernes, og bogstaverne konverteres til store bogstaver. |
Svar
Kontrollér status.code i JSON-indholdet samt HTTP-statussen. response er et array, der indeholder id, name og available_groups. Brug name som number_type, når du kalder get_requirements; send ikke id i stedet. available_groups er antallet af gruppeposter, der returneres for den pågældende type, ikke antallet af telefonnumre i beholdningen eller en fuldstændig total på tværs af alle sider. Typer, hvor der ikke returneres nogen grupper, udelades. Den foretrukne rækkefølge er Local, Mobile, National, Toll Free, Shared Cost, Global, efterfulgt af andre navne i kataloget.
Illustration af svarstrukturen; ikke aktuelle kontodata eller et aktuelt pristilbud.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"id": "NUMBER_TYPE_ID_FROM_RESPONSE",
"name": "Local",
"available_groups": 3
}
]
}Fejl
- 400: country is required: angiv registreringslandets ISO-kode.
- 400: Invalid country ISO or no available DID registration country found: vælg et land fra det aktuelle registreringskatalog; dette fastslår ikke, at der ikke kræves dokumenter.
Tilgængelighed og sideeffekter
- Dette opslag i kataloget eller kravene opretter ikke en identitet, uploader ikke dokumentation, registrerer ikke et nummer og afgiver ikke en ordre.
- Et vellykket katalogsvar er ikke en godkendelse af dine dokumenter eller en bekræftelse på, at et valgt nummer kan aktiveres.