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/getbalance"Комуникациони v3 API враћа резултат апликације унутар JSON тела одговора. Проверите HTTP статус и status.code пре читања response; одбијени захтев можда нема објекат одговора. Вредности кодова могу бити стрингови или бројеви.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "25.0000",
"currency": "USD",
"terms": "Prepaid"
}
}Ово је измишљен пример, а не стварно стање налога. Новчане вредности третирајте као децималне износе. Приликом дијагностиковања одбијеног захтева сачувајте поруку коју је вратио сервер, уз уклоњене акредитиве.
Правилно користите податке о наплати
Одговор о стању садржи тренутно стање, валуту и услове плаћања. Не даје цену будућег позива нити комплетан рачун. За та питања користите одговарајуће операције за цене и потрошњу. Постојећи бројеви могу имати планове другачије од данашњег каталога.
Обрада грешака и поновних покушаја
- Неуспела аутентификација или дозвола
- Проверите да ли је API акредитив омогућен, као и дозвољену услугу и ограничење изворне IP адресе. Колачић сесије портала није акредитив за интеграцију.
- Недовољно кредита или неиспуњено одобрење
- Решите питање стања налога, одобрења за слање или захтева за документацију пре него што поновите операцију.
- Нема резултата
- Празан инвентар или непостојеће име позиваоца третирајте као уобичајен исход. Не претпостављајте да синтаксно исправан број има све услуге.
- Истек мрежне везе или отказивање услуге
- За читање користите ограничен број поновних покушаја са повећањем размака (backoff). Код куповине, слања или регистрације прво проверите стање операције; поновно слање прихваћеног захтева може дуплирати наплативу радњу.
Подршка за идемпотентност зависи од сваке породице API-ја. API за хитне позиве подржава кључеве за поновни покушај; то не значи да је произвољан v3 захтев идемпотентан. За подршку сачувајте временске ознаке, враћене ID-јеве и одговоре са уклоњеним осетљивим подацима.
Наставите са референцом вашег налога
Референца за пријављене кориснике филтрира операције према вашим дозволама и омогућеним сервисима. Користите тачан хост, тип креденцијала, поља захтева и шему одговора из ње. Конзоле могу извршавати операције уживо, укључујући куповине и поруке.