REST API документација
REST API-ји за SMS и MMS
Шаљите одобрене поруке апликације и обрађујте прихватање, догађаје испоруке, сегментацију и накнаде.
Изаберите 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 интеграције.
Припрема SMS захтева
Користите одобрен број пошиљаоца са омогућеним SMS-ом који припада налогу, примаоца који је пристао на поруку и потребну проверу бренда/кампање или броја бесплатног за позиваоца. Пример у наставку шаље стварну поруку када се попуни исправним акредитивима и бројевима; није тестно окружење.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Замените резервисана места пошиљаоца и примаоца међународним цифрама укључујући позивни број државе. За MMS наведите подржани, јавно доступан URL медија у media и прво проверите подобност за MMS и цене.
Прихватање није испорука
Проверите и спољашњи статус апликације и враћени резултат слања поруке. Забележите идентификатор поруке који даје услуга и пратите статус испоруке и webhook догађаје. Успешно слање не може доказати да је телефон примаоца примио поруку.
SMS се наплаћује по сегменту. Кодирање и дужина поруке могу дати више сегмената; медији и трошкови везани за оператере могу се разликовати од SMS-а. Прочитајте тренутну продајну цену налога пре слања. Никада слепо не понављајте слање које је истекло: прво проверите његов забележени исход.
Обрада грешака и поновних покушаја
- Неуспела аутентификација или дозвола
- Проверите да ли је API акредитив омогућен, као и дозвољену услугу и ограничење изворне IP адресе. Колачић сесије портала није акредитив за интеграцију.
- Недовољно кредита или неиспуњено одобрење
- Решите питање стања налога, одобрења за слање или захтева за документацију пре него што поновите операцију.
- Нема резултата
- Празан инвентар или непостојеће име позиваоца третирајте као уобичајен исход. Не претпостављајте да синтаксно исправан број има све услуге.
- Истек мрежне везе или отказивање услуге
- За читање користите ограничен број поновних покушаја са повећањем размака (backoff). Код куповине, слања или регистрације прво проверите стање операције; поновно слање прихваћеног захтева може дуплирати наплативу радњу.
Подршка за идемпотентност зависи од сваке породице API-ја. API за хитне позиве подржава кључеве за поновни покушај; то не значи да је произвољан v3 захтев идемпотентан. За подршку сачувајте временске ознаке, враћене ID-јеве и одговоре са уклоњеним осетљивим подацима.
Наставите са референцом вашег налога
Референца за пријављене кориснике филтрира операције према вашим дозволама и омогућеним сервисима. Користите тачан хост, тип креденцијала, поља захтева и шему одговора из ње. Конзоле могу извршавати операције уживо, укључујући куповине и поруке.