REST API-dokumentasie
Foonnommer-REST-API's
Ontdek beskikbare lande en nommers, ondersoek die volledige aanbod en bestuur die nommers wat jy besit.
Kies die API en aanmeldbesonderhede saam
Goedgekeurde rekeninge vir Ontwikkelaar en Outomatisering, Besigheid en Kommunikasieverskaffers kan geaktiveerde dienste integreer. 'n Individuele ontwikkelaar hoef nie voor te gee om 'n maatskappy te wees nie. SMS/MMS vanaf toepassings vereis die toepaslike versendingsgoedkeuring en registrasie. Die diens vir Individue en gesinne het geen API wat kliënte kan gebruik om boodskappe te stuur nie.
| API-familie | Basis-URL | Stawing en resultaat |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | Goedgekeurde Basic-aanmeldbesonderhede; toepaslike uitgereikte tokens slegs vir bewerkings wat dit ondersteun. JSON status en response. |
| Registrasie vir noodoproepe | https://api.multi.tel/emergency | Goedgekeurde Basic-aanmeldbesonderhede of spesifiek geaktiveerde bearer-toegang. JSON code, message en data. |
| Portaal-REST-integrasies | Gasheer en bewerking word in jou rekening se ontwikkelaarverwysing getoon | Gebruik daardie bewerking se gedokumenteerde aanmeldbesonderhede, toestemmingsomvang en skema. Blaaier-sessieversoeke gebruik 'n afsonderlike koppelvlak. |
Stel MULTITEL_API_USERNAME en MULTITEL_API_PASSWORD deur jou bediener se geheimekonfigurasie in voordat jy die voorbeelde gebruik. Moet dit nooit in openbare blaaier-JavaScript, URL's of bronbeheer inbed nie. Afsonderlike aanmeldbesonderhede word in API-integrasie-instellings bestuur.
Lees die beskikbare landkatalogus
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"Die v3-respons bevat status en 'n response-skikking. Landinskrywings sluit isocode, name, countrycode, vermoë-inligting en next_function in. Beskikbaarheid is rekening- en voorraadafhanklik; 'n land is nie 'n belofte dat elke voorvoegsel of nommersoort in voorraad is nie.
{
"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"
}
]
}Van ontdekking tot aktivering
- Kies die land, onderverdeling waar vereis, gebied en nommersoort deur die ooreenstemmende geografiebewerkings te gebruik.
- Lees die geselekteerde nommer se opstel-, maandelikse en gebruikspryse, kanale, ingeslote gebruikstoelae en registrasievereistes.
- Dien die vereiste eindgebruikersdokumente in en hersien hul status. 'n Nommer kan hangende bly tot goedkeuring.
- Bestel eenkeer met die presiese voorraad/pryskeuse. As die respons onseker is, inspekteer jou voorraad voordat jy nog 'n bestelling indien.
- Konfigureer stemroetering en boodskapaflewering onafhanklik, toets dan die volledige beoogde roete.
Hanteer foute en herprobeerslae
- Stawing- of toestemmingsfout
- Kontroleer of die API-aanmeldbesonderhede geaktiveer is, watter diens toegelaat word en watter bron-IP-beperking geld. 'n Portaal-sessiekoekie is nie aanmeldbesonderhede vir 'n integrasie nie.
- Onvoldoende krediet of ontbrekende vereiste goedkeuring
- Los eers enige probleem met die rekeningsaldo, versendingsgoedkeuring of dokumentvereiste op voordat jy die bewerking herhaal.
- Geen resultaat nie
- Hanteer leë voorraad of 'n ontbrekende bellernaam as 'n gewone uitkoms. Moenie aanneem dat 'n sintakties geldige nommer elke diens het nie.
- Netwerktydverstreking of diensfout
- Gebruik 'n beperkte aantal herprobeerslae met wagtye tussen pogings vir leesbewerkings. Vir 'n aankoop, versending of registrasie, inspekteer eers die bewerkingstatus; om 'n aanvaarde versoek weer te probeer, kan 'n faktureerbare aksie dupliseer.
Ondersteuning vir idempotensie is spesifiek aan elke API-familie. Die Emergency-API ondersteun sleutels vir herprobeerslae; dit maak nie arbitrêre v3-versoeke idempotent nie. Behou tydstempels, teruggegewe ID's en response waarvan sensitiewe besonderhede verwyder is vir ondersteuning.
Gaan voort met jou rekening se verwysing
Die verwysingsdokumentasie wat jy ná aanmelding sien, filtreer bewerkings volgens jou toestemmings en geaktiveerde dienste. Gebruik die presiese gasheer, tipe aanmeldbesonderhede, versoekvelde en responsskema daarin. Die konsoles kan werklike bewerkings uitvoer, insluitend aankope en die stuur van boodskappe.