HU/EN
Belépés Demó kérése

API dokumentáció

Technikai áttekintés a BitMessaging HTTPS SMS, Viber, WhatsApp és Email2SMS integrációkhoz.

  • API hozzáférés előtt IP whitelist szükséges
  • Azonosítás ügyfélszolgálat által kiadott username és password párossal
  • A hozzáférési adatokat szerveroldalon kell kezelni, böngészőben vagy frontend kódban nem szabad megjeleníteni
  • A küldés GET és POST hívással is működik; a publikus példák POST body paramétereket mutatnak, nem URL-ben szereplő jelszót
  • A JSON válasz message ID-kat ad vissza
  • A státusz lekérdezhető vagy callbackkel visszaküldhető
  • Rate limit és átviteli kapacitás éles forgalom előtt egyeztetendő
  • SMPP hozzáférés nagy volumenű vagy speciális integráció esetén egyeztethető
export BM_API_USERNAME="kiadott_username"
export BM_API_PASSWORD="kiadott_password"

curl -X POST "https://bitmessaging.com/api/v1/send/?json=1" \
  --data-urlencode "username=$BM_API_USERNAME" \
  --data-urlencode "password=$BM_API_PASSWORD" \
  --data-urlencode "receiver=36301234567" \
  --data-urlencode "text=Teszt uzenet" \
  --data-urlencode "charset=7bit" \
  --data-urlencode "method=sms" \
  --data-urlencode "callback=1"

HTTPS API működése

A publikus fejlesztői információ a tényleges BitMessaging küldési folyamatot követi: a hozzáférés előre engedélyezett ügyféloldali IP-címekről működik, az azonosítás a kiadott username/password párral történik, a küldés válasza pedig message ID-t ad vissza a státuszkövetéshez. A hozzáférési adatokat szerveroldalon kell tárolni, frontend kódban vagy böngészős hívásban nem szabad megjeleníteni.

Hozzáférés

Élesítés előtt a szerver IP-címét whitelistelni kell. Nem engedélyezett IP vagy hibás belépési adatok esetén a válasz NO ACCESS.

Küldés

Az üzenetek a https://bitmessaging.com/api/v1/send/?json=1 végpontra küldhetők GET vagy POST hívással. A publikus példák POST paramétereket mutatnak, hogy a jelszó ne az URL-ben szerepeljen.

Státusz

A JSON válasz message ID-t tartalmaz. A státusz a /api/v1/status/ végponton kérdezhető le, vagy callback URL-re küldhető vissza.

Fontos paraméterek

  • receiver: nemzetközi telefonszám formátum + jel nélkül, kizárólag számokkal
  • charset: 7bit GSM szöveghez vagy unicode teljes ékezetes szöveghez
  • method: sms, viber, whatsapp, viber-sms, whatsapp-sms, whatsapp-viber-sms, viber-whatsapp-sms
  • callback: 0 esetén nincs visszajelzés, 1 esetén a rendszer a korábban megadott URL-re küld státuszt
  • státuszok: started, sent, buffered, delivered, undeliverable, rejected, expired, deleted

Email2SMS lehetőség

Az Email2SMS akkor hasznos, ha egy üzleti rendszer könnyebben indít e-mailt, mint API-hívást. Az e-mail csak trigger: SMTP fogadás után a BitMessaging létrehozza az SMS-küldési kérést, a státuszkezelés pedig a platformon belül történik.

  • Dedikált SMTP végpont: bitmessaging.com
  • TLS/SSL és SMTP autentikáció
  • Kötelező IP whitelist
  • Címzett formátum: 3630XXXXXXXX@bitmessaging.com
  • A Subject tartalmazza az SMS szövegét, a Body figyelmen kívül marad
  • Emailben nincs kézbesítési visszajelzés; státusz HTTP API-n vagy webes felületen ellenőrizhető

Példa válasz

{
  "messages": [
    "4fd88ad0-b945-11e5-9078-00163e536649"
  ]
}

{
  "messages": [{
    "status": "delivered",
    "delivery_time": 1,
    "receiver": "36301234567",
    "date": "2026-07-19T10:15:00",
    "destination_network": "3630",
    "message_id": "61330468-b931-11e5-bbc7-00163e536649"
  }]
}
Demó kérése