BulkGate Helpdesk
  • Languages iconCzech
    • English

›Specifikace

Specifikace

  • Odeslání One Time Password (OTP)
  • Oveření One Time Password (OTP)
  • Přeposlání One Time Password (OTP)

Odeslání One Time Password (OTP)

API URL

Adresa URL používaná k odeslání požadavků HTTP:

https://portal.bulkgate.com/api/1.0/otp/send
POST /api/1.0/otp/send HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache

Tabulka parametrů

JMÉNO PARAMETRUHODNOTAPOVINNÉVÝCHOZÍ HODNOTA
application_idApplication IDAno-
application_tokenApplication tokenAno-
numberTelefonní číslo, na které bude kód odeslánAno-
countryKód země daného telefonního číslaNeHodnota je brána z profilu.
languageJazyk odeslané zprávyNeen
code_typeTyp odeslaného kódu (string, int, or combined)Neint
code_lengthDélka verifikačního kódu (4-20)Ne6
request_quota_numberPočet požadavků za minutu pro identifikaci request_quota_identificationNe1
request_quota_identificationIdentifikace "uživatele/žadatele OTP", na kterého se bude uplatňovat kvóta request_quota_number za minutu. Doporučujeme pro tuto identifikaci používat IP adresu.Ano-
channelAlternativní kanály. Kanály jsou seřazeny v kaskádě, pokud tedy není možné doručit zprávu skrze prioritní kanál, budou použity kanály níže v kaskádě. Pokud ani jeden z alternativních kanálu nedokáže doručit zprávu bude použita SMS.NeSMS object

Tabulka parametrů SMS objektu

JMÉNO PARAMETRUHODNOTAPOVINNÉVÝCHOZÍ HODNOTA
sender_idSender ID, VIZ sender ID typeNegSystem
sender_id_valueSender value gOwn, gText, gProfile, gMobile nebo gPush (pokud je použita gMobile nebo gPush, poskytněte prosím mobile connect key jako sender_id_value)Nenull
unicodeYes/true/1 pro Unicode SMS, no/false/0 pro 7bit SMSNefalse

Tabulka parametrů Viber objektu

JMÉNO PARAMETRUHODNOTAPOVINNÉVÝCHOZÍ HODNOTA
senderVáš zaregistrovaný odesilatel pro ViberNe""
expirationDoba v sekundách po které bude zpráva odeslána dalším kanálem v pořadí v případě nedoručení.Ne120

Příklad úplného požadavku

POST /api/1.0/otp/send HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
Cache-Control: no-cache

{
  "application_id": "APPLICATION_ID",
  "application_token": "APPLICATION_TOKEN",
  "number": "PHONE_NUMBER",
  "country": "cz",
  "language": "cs",
  "code_type": "string",
  "code_length": 7,
  "request_quota_number": 1,
  "request_quota_identification": "127.0.0.1",
  "channel": {
    "viber": {
      "sender": "Lt. Hagan",
      "expiration": 100
    },
    "sms": {
      "sender_id": "gText",
      "sender_id_value": "Lt-Hagan",
      "unicode": true
    }
  }
}

Odpověď na tento příkaz může být:

V případě úspěchu:

{
    "data": {
        "id": "otp-id"
    }
}

V případě chyby:

{
    "type": "unknown_identity",
    "code": 400,
    "error": "Unknown identity",
    "detail": null
}
{
    "type": "invalid_input_parameters",
    "code": 400,
    "error": "Invalid input parameters",
    "detail": null
}
Další →
  • API URL
    • Tabulka parametrů
    • Tabulka parametrů SMS objektu
    • Tabulka parametrů Viber objektu
    • Příklad úplného požadavku
  • Odpověď na tento příkaz může být:
ŘešeníSMS BránaViber BusinessBroadcastHromadné SMSSMS notifikace2 way SMSSmart SMSMobile ConnectWeb Portál
Partneři a vývojářiSMS APIIntegraceAffiliate programWhite label
ZdrojeBlogYouTubeFacebookLinkedInTwitterGitHubPackagist
SpolečnostKontaktZásady ochrany osobních údajůObchodní podmínky
CeníkyCeník SMSCeník ViberCeník Mobile Connect
SMS BránaTOPefekt s.r.o. © 2022