REST API документација
REST API-ји за телефонске бројеве
Пронађите доступне земље и бројеве, прегледајте комплетну понуду и управљајте бројевима које поседујете.
Изаберите API и акредитив заједно
Одобрени налози за програмере и аутоматизацију, пословне кориснике и пружаоце комуникационих услуга могу интегрисати омогућене услуге. Појединачни програмер не мора да се представља као компанија. Апликативни SMS/MMS захтева одговарајуће одобрење за слање и регистрацију. Услуга за појединце и породице нема корисницима доступан API за иницирање слања порука.
| Породица API-ја | Основни URL | Аутентификација и резултат |
|---|---|---|
| Комуникације v3 | https://api.multitel.net/v3 | Одобрени Basic акредитиви; одговарајући додељени токени само за операције које их подржавају. JSON status и response. |
| Регистрација за хитне позиве | https://api.multi.tel/emergency | Одобрени Basic акредитиви или посебно додељен bearer приступ. JSON code, message и data. |
| REST интеграције портала | Хост и операција приказани у развојној референци вашег налога | Користите документоване акредитиве, опсеге приступа и шему те операције. Захтеви из сесије прегледача представљају засебан начин приступа. |
Пре коришћења примера подесите MULTITEL_API_USERNAME и MULTITEL_API_PASSWORD кроз конфигурацију тајни на вашем серверу. Никада их не уграђујте у јавни JavaScript у прегледачу, URL-ове или контролу изворног кода. Наменским акредитивима се управља у подешавањима API интеграције.
Читање каталога доступних држава
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"v3 одговор садржи status и низ response. Уноси за државе укључују isocode, name, countrycode, информације о могућностима и next_function. Доступност зависи од налога и инвентара; држава није обећање да је сваки префикс или тип броја на лагеру.
{
"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"
}
]
}Од претраге до активације
- Изаберите државу, поделу где је потребна, област и тип броја помоћу одговарајућих географских операција.
- Прочитајте цене постављања, месечне цене и цене коришћења изабраног броја, канале, дозвољену количину и захтеве за регистрацију.
- Пошаљите потребна документа крајњег корисника и пратите њихов статус. Број може остати на чекању до одобрења.
- Поручите једном са тачним избором инвентара и цене. Ако је одговор нејасан, проверите свој инвентар пре слања нове поруџбине.
- Подесите гласовно рутирање и испоруку порука независно, а затим тестирајте целу предвиђену путању.
Обрада грешака и поновних покушаја
- Неуспела аутентификација или дозвола
- Проверите да ли је API акредитив омогућен, као и дозвољену услугу и ограничење изворне IP адресе. Колачић сесије портала није акредитив за интеграцију.
- Недовољно кредита или неиспуњено одобрење
- Решите питање стања налога, одобрења за слање или захтева за документацију пре него што поновите операцију.
- Нема резултата
- Празан инвентар или непостојеће име позиваоца третирајте као уобичајен исход. Не претпостављајте да синтаксно исправан број има све услуге.
- Истек мрежне везе или отказивање услуге
- За читање користите ограничен број поновних покушаја са повећањем размака (backoff). Код куповине, слања или регистрације прво проверите стање операције; поновно слање прихваћеног захтева може дуплирати наплативу радњу.
Подршка за идемпотентност зависи од сваке породице API-ја. API за хитне позиве подржава кључеве за поновни покушај; то не значи да је произвољан v3 захтев идемпотентан. За подршку сачувајте временске ознаке, враћене ID-јеве и одговоре са уклоњеним осетљивим подацима.
Наставите са референцом вашег налога
Референца за пријављене кориснике филтрира операције према вашим дозволама и омогућеним сервисима. Користите тачан хост, тип креденцијала, поља захтева и шему одговора из ње. Конзоле могу извршавати операције уживо, укључујући куповине и поруке.