Gå til indholdet

SMSBAT ChatHub API

ChatHub REST API administrerer Viber-forretningschats, klientsamtaler og automatiseringsarbejdsgange for kundesupport.

Basis-URL

https://chatapi.smsbat.com

Swagger-dokumentation

Interaktiv API-dokumentation er tilgængelig på:

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

Godkendelse

ChatHub bruger et Bearer-token-baseret autentificeringssystem med JWT-tokens. Tokens kan overføres på to måder:

Metode 1: Autorisationshoved

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

Metode 2: X-Authorization-Key Header

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

Autentificeringsflow

ChatHub bruger et to-niveau token-system:

  1. Company Token - Adgangstoken på organisationsniveau
  2. Operator Token - Individuel operatøradgangstoken

Workflow

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

Hovedendepunkter

Metode Slutpunkt Beskrivelse
POST /api/company/get-token Få firmaautorisationstoken
FÅ /api/virksomhed/organisation Hent organisationsliste
FÅ /api/operator Liste operatører efter organisation
POST /api/operator/synchronize Tilføj nye operatører
POST /api/operatør/status Skift operatørstatus
POST /api/operator/get-token Generer operatørtokens (maks. 24 timers udløb)
POST /api/operator/validate-token Bekræft tokens gyldighed

Nøglefunktioner

Company Token Management

Få og administrer tokens på organisationsniveau til API-adgang.

Organisationsledelse

  • Liste over alle organisationer
  • Hent organisationsoplysninger
  • Administrer organisationsindstillinger

Operatørstyring

  • Liste operatører efter organisation
  • Tilføj nye operatører
  • Skift operatørstatus (Aktiv/Inaktiv/Slettet)
  • Generer operatørspecifikke tokens (maks. 24 timer)
  • Valider operatør tokens

Widget-integration

Integrer ChatHub-widget i webapplikationer til kundesupport i realtid.

Hurtig start

  1. Godkendelse - Få dit firma- og operatør-tokens
  2. Organisationer - Administrer organisationer
  3. Operatorer - Tilføj og administrer operatører
  4. Widget-integration - Integrer chat-widget

Forespørgselsformat

Alle anmodninger bruger JSON-format:

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

Svarformat

Vellykkede svar returnerer:

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

Fejlhåndtering

HTTP-statuskoder:

  • 200 OK - Forespørgsel gennemført
  • 400 Bad Request - Ugyldigt anmodningsformat
  • 401 Uautoriseret - Godkendelse mislykkedes
  • 403 Forbidden - Utilstrækkelige tilladelser
  • 404 ikke fundet - Ressource ikke fundet
  • 500 Intern serverfejl - Serverfejl

Token-udløb

Tokens har en udløbstid. Når et token udløber:

  1. API'en returnerer "401 Uautoriseret".
  2. Anmod om et nyt token ved hjælp af godkendelsesslutpunktet
  3. Opdater din applikation med det nye token

Næste trin