REST API-dokumentation
REST API'er til telefonnumre
Find tilgængelige lande og numre, gennemgå det komplette tilbud, og administrer de numre, du ejer.
Vælg API og legitimation sammen
Godkendte konti med profilerne Udvikler og automatisering, Erhverv og Kommunikationsudbydere kan integrere aktiverede tjenester. En individuel udvikler behøver ikke give sig ud for at være en virksomhed. SMS/MMS fra applikationer kræver den relevante afsendelsesgodkendelse og registrering. Tjenesten for Privatpersoner og familier har ingen API tilgængelig for kunder til afsendelse af beskeder.
| API-familie | Basis-URL | Autentificering og resultat |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | Godkendt Basic-legitimation; kvalificerede tildelte tokens kun til handlinger, der understøtter dem. JSON status og response. |
| Nødopkaldsregistrering | https://api.multi.tel/emergency | Godkendt Basic-legitimation eller specifikt tildelt bearer-adgang. JSON code, message og data. |
| Portal-REST-integrationer | Vært og handling vist i din kontos udviklerreference | Brug den pågældende handlings dokumenterede legitimation, scopes og skema. Anmodninger fra browsersessioner bruger en separat grænseflade. |
Angiv MULTITEL_API_USERNAME og MULTITEL_API_PASSWORD via din servers konfiguration af hemmeligheder, før du bruger eksemplerne. Indlejr dem aldrig i offentlig JavaScript i browseren, i URL’er eller i kildekodestyring. Dedikerede legitimationsoplysninger administreres i indstillinger for API-integration.
Læs kataloget over tilgængelige lande
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"v3-svaret indeholder status og et response-array. Landeposter omfatter isocode, name, countrycode, oplysninger om funktioner og next_function. Tilgængelighed afhænger af konto og lager; et land er ikke et løfte om, at alle præfikser eller nummertyper er på lager.
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}Fra søgning til aktivering
- Vælg land, evt. underinddeling hvor det kræves, område og nummertype ved hjælp af de tilsvarende geografihandlinger.
- Læs det valgte nummers oprettelsespris, månedlige pris og forbrugspriser, kanaler, inkluderet forbrug og registreringskrav.
- Indsend de krævede slutbrugerdokumenter, og følg deres status. Et nummer kan forblive afventende, indtil det er godkendt.
- Bestil én gang med det præcise valg af lager og pris. Hvis svaret er usikkert, skal du kontrollere dit lager, før du afgiver endnu en bestilling.
- Konfigurér stemmeroutning og meddelelseslevering hver for sig, og test derefter hele den tilsigtede rute.
Håndtering af fejl og nye forsøg
- Fejl i autentificering eller tilladelser
- Kontrollér, om API-legitimationen er aktiveret, hvilken tjeneste den har tilladelse til, og hvilke begrænsninger der gælder for kilde-IP. En portalsessions-cookie er ikke en integrationslegitimation.
- Utilstrækkelig saldo eller manglende godkendelse
- Løs problemet med kontosaldoen, afsendelsesgodkendelsen eller dokumentkravet, før du gentager handlingen.
- Intet resultat
- Behandl et tomt lager eller et manglende opkaldsnavn som et almindeligt udfald. Antag ikke, at et syntaktisk gyldigt nummer har alle tjenester.
- Netværkstimeout eller tjenestefejl
- Brug begrænsede nye forsøg med backoff ved læsninger. Ved et køb, en afsendelse eller en registrering skal du først kontrollere handlingens tilstand; et nyt forsøg på en accepteret anmodning kan duplikere en handling, der medfører betaling.
Understøttelse af idempotens gælder for den enkelte API-familie. Emergency API’et understøtter nøgler til nye forsøg; det gør ikke vilkårlige v3-anmodninger idempotente. Gem tidsstempler, returnerede ID’er og svar, hvor følsomme oplysninger er fjernet, til support.
Fortsæt med din kontos reference
Den indloggede reference filtrerer operationer efter dine rettigheder og aktiverede tjenester. Brug dens præcise host, legitimationstype, forespørgselsfelter og svarskema. Konsollerne kan udføre live-operationer, herunder køb og beskeder.