BulkGate Helpdesk
  • Languages iconCzech
    • English

›Transakční SMS

Transakční SMS

  • Specifikace
  • Metoda GET
  • Metoda POST - json
  • Metoda POST - form

Propagační SMS

  • Specifikace
  • Metoda GET
  • Metoda POST - json
  • Metoda POST - form

Ověření stavu kreditu

  • Ověření stavu kreditu
  • Požadavky

API Administrace a tokeny

  • API administrace a tokeny

Příklady implementace

  • Příklady transakční SMS
  • Příklady propagační SMS

Typy errorů

  • Typy errorů API

Potvrzení o doručení a příchozí SMS

  • Potvrzení o doručení a příchozí SMS
  • Hromadné potvrzení o doručení příchozích zpráv

Specifikace

API URL

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

https://portal.bulkgate.com/api/1.0/simple/transactional

Podporované HTTP metody

  • GET
  • POST - application/x-www-form-urlencoded
  • POST - application/json

Zneužití transakční SMS pro propagační/marketingové účely je přísně zakázáno! Musí být použito pouze pro informační účely - jako informační SMS.

Tabulka s parametry

NÁZEV PARAMETRUHODNOTAPOVINNÝVÝCHOZÍ HODNOTA
application_idAplikační identifikátorAno-
application_tokenAplikační ověřovací tokenAno-
numberČíslo příjemceAno-
textText SMS zprávy (max. 612 znaků nebo 268 znaků, jestliže je aktivován Unicode), UTF-8 kódováníAno-
unicodeYes/true/1 pro Unicode SMS, no/false/0 pro 7bit SMSNefalse
sender_idID odesílatele, viz typ ID odesílateleNegSystem
sender_id_valueHodnota odesílatele - gOwn (např. "420 777 777 777"), gText (např. "BulkGate"), gProfile (např. "423"), gMobile or gPush (KEY)Nenull
countryPoskytněte čísla příjemců v mezinárodním formátu (s prefixem, např. 420) nebo přidejte kód země ve formátu ISO 3166-1 alpha-2 (775123456 + CZ = 420775123456). Podívejte se na příklad požadavku země. Pokud je hodnota null, je použita země z vašeho uživatelského profilu.Nenull
scheduleNaplánujte čas a datum odesílání v unix timestamp, nebo ISO 8601.NeNyní
duplicates_checkZvolte možnost on, chcete-li zabránit odesílání duplicitních zpráv na stejné telefonní číslo. Zprávy se stejným textem zaslaným na stejné číslo budou odstraněny, pokud je časový interval kratší než 5 minut. Pokud je aktivní možnost off, žádné duplikáty nebudou odstraněny.Neoff
tagOznačení zpráv pro následné dohledání uživateleNe-

Typ ID odesílatele sender_id

HODNOTAVÝZNAM
gSystemSystémové číslo
gShortShort Code
gTextTextový odesílatel
gMobileMobile Connect
gPushMobile Connect push - Odešle notifikaci do vaší Mobile Connect aplikace
gOwnVlastní číslo (vyžaduje ověření čísla)
gProfileBulkGate Profil ID
<int>BulkGate Profil ID

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

V případě úspěchu:

{
    "data": {
        "status": "accepted",
        "sms_id": "tmpde1bcd4b1d1",
        "price": 0.02,
        "credit": 215.81380,
        "number": "420777777777"
    }
}

V případě chyby:

{
    "type": "invalid_phone_number",
    "code": 400,
    "error": "Neplatné číslo",
    "detail": null
}
{
    "type": "unknown_identity",
    "code": 401,
    "error": "Neznámá identita / neautorizovaná / prázdná application_id",
    "detail": null
}

Kde:

  • type a error (popisek erroru) můžete vidět v tabulce typů errorů,
  • code představuje http error
  • detail je dodatečná informace o erroru

Všechny typy errorů pro Simple API a Advanced API můžete najít zde.

Další →
  • API URL
    • Podporované HTTP metody
  • Tabulka s parametry
    • Typ ID odesílatele sender_id
  • 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. © 2023