Skip to content

SMSBAT ChatHub API

ChatHub REST API upravlja Viber poslovnim razgovorima, razgovorima s klijentima i procesima automatizacije korisničke podrške.

Osnovni URL

https://chatapi.smsbat.com

Swagger dokumentacija

Interaktivna API dokumentacija dostupna je na:

https://chatapi.smsbat.com/index.html

Autentifikacija

ChatHub koristi Bearer token-based autentifikacijski sistem sa JWT tokenima. Tokeni se mogu proslijediti na dva načina:

Metoda 1: Zaglavlje autorizacije

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "Authorization: Bearer your-jwt-token"

Metoda 2: Zaglavlje ključa za X-autorizaciju

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "X-Authorization-Key: your-jwt-token"

Protok autentifikacije

ChatHub koristi sistem tokena na dva nivoa:

  1. Token kompanije - Token pristupa na nivou organizacije
  2. Token operatera - Token za pristup pojedinačnog operatera

Tok rada

graph LR
    A[Get Company Token] --> B[List Organizations]
    B --> C[List/Add Operators]
    C --> D[Get Operator Token]
    D --> E[Integrate Widget]

Glavne krajnje tačke

Metoda Krajnja tačka Opis
POST /api/company/get-token Nabavite token autorizacije kompanije
GET /api/kompanija/organizacija Dohvati listu organizacija
GET /api/operator Lista operatera po organizaciji
POST /api/operator/synchronize Dodaj nove operatere
POST /api/operator/status Promjena statusa operatera
POST /api/operator/get-token Generirajte operatorske tokene (maks. 24h isteka)
POST /api/operator/validate-token Provjeri valjanost tokena

Ključne karakteristike

Upravljanje tokenima kompanije

Nabavite i upravljajte tokenima na nivou organizacije za pristup API-ju.

Upravljanje organizacijom

  • Navedite sve organizacije
  • Dohvatite detalje organizacije
  • Upravljajte postavkama organizacije

Upravljanje operaterom

  • Navedite operatere po organizaciji
  • Dodajte nove operatere
  • Promjena statusa operatera (Aktivan/Neaktivan/Izbrisan)
  • Generirajte tokene specifične za operatera (maksimalno 24 sata)
  • Potvrdite tokene operatera

Integracija vidžeta

Integrirajte ChatHub widget u web aplikacije za korisničku podršku u realnom vremenu.

Brzi početak

  1. Autentifikacija - Nabavite tokene svoje kompanije i operatera
  2. Organizacije - Upravljajte organizacijama
  3. Operatori - Dodajte i upravljajte operaterima
  4. Integracija vidžeta - Integracija vidžeta za razgovor

Format zahtjeva

Svi zahtjevi koriste JSON format:

{
  "login": "your-login",
  "password": "your-password"
}

Format odgovora

Uspješni odgovori vraćaju:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiration": "2025-01-24T12:00:00Z"
}

Rukovanje greškama

HTTP statusni kodovi:

  • 200 OK - Zahtjev uspješan
  • 400 loših zahtjeva - Nevažeći format zahtjeva
  • 401 Neovlašteno - Autentifikacija nije uspjela
  • 403 Zabranjeno - Nedovoljne dozvole
  • 404 nije pronađeno - Resurs nije pronađen
  • 500 Interna greška servera - Greška servera

Istek tokena

Tokeni imaju vrijeme isteka. Kada istekne token:

  1. API će vratiti 401 Neovlašteno
  2. Zatražite novi token koristeći krajnju točku provjere autentičnosti
  3. Ažurirajte svoju aplikaciju novim tokenom

Sljedeći koraci