Help Center Аутхентицатион

Аутхентицатион

СМСБАТ ЦхатХуб АПИ користи систем аутентификације заснован на ЈВТ токенима на два нивоа са токенима компаније и токенима оператера.

Ток аутентификације

graph TD
    A[Login Credentials] --> B[Get Company Token]
    B --> C[Use Company Token]
    C --> D[Get Operator Token]
    D --> E[Use Operator Token]
    E --> F[Validate Token]

Токен компаније

Токени компаније пружају приступ ЦхатХуб АПИ-ју на нивоу организације.

Набавите токен компаније

Крајња тачка: ПОСТ /апи/цомпани/гет-токен

Захтев:

curl -X POST https://chatapi.smsbat.com/api/company/get-token \
  -H "Content-Type: application/json" \
  -d '{
    "login": "your-company-login",
    "password": "your-company-password"
  }'

Тело захтева:

{
  "login": "string",
  "password": "string"
}

Одговор:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

Одговор је низ ЈВТ токена.

Користите токен компаније

Укључите токен компаније у АПИ захтеве користећи један од два метода:

Метод 1: Заглавље ауторизације (препоручено)

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

Метод 2: Заглавље кључа Кс-Аутхоризатион-Кеи

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

Токен оператера

Токени оператера омогућавају приступ специфичан за кориснике за појединачне оператере унутар организације.

Набавите токен оператера

Крајња тачка: ПОСТ /апи/оператор/гет-токен

Захтев:

curl -X POST https://chatapi.smsbat.com/api/operator/get-token \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 123,
    "expiresAt": "2025-12-31T23:59:59Z"
  }'

Тело захтева:

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}

Параметри:

Параметар	Тип	Обавезно	Опис
`ид`	цео број	Да	ИД оператера
`екпиресАт`	стринг (ИСО 8601)	Да	Датум и време истека токена (максимално 24 сата од сада)

Важно: Максимални век трајања токена је 24 сата. Параметар екпиресАт не може бити дужи од 24 сата у будућности.

Одговор:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcGVyYXRvcl9pZCI6MTIzLCJleHAiOjE3Mzc0MTI3OTl9.example_signature"

Користи токен оператера

Укључите токен оператера у АПИ захтеве:

curl -X GET https://chatapi.smsbat.com/api/operator \
  -H "Authorization: Bearer {operator-token}"

Валидација токена

Проверите да ли је токен још увек важећи пре него што га употребите.

Крајња тачка: ПОСТ /апи/оператор/валидате-токен

Захтев:

curl -X POST https://chatapi.smsbat.com/api/operator/validate-token \
  -H "Authorization: Bearer {company-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }'

Тело захтева:

{
  "token": "string"
}

Одговор (важећи токен):

{
  "isValid": true,
  "operatorId": 123,
  "clientId": 0,
  "expiresAt": "2025-12-31T23:59:59Z",
  "error": null
}

Одговор (неважећи токен):

{
  "isValid": false,
  "error": "Invalid token"
}

Истек токена

Токени компаније

Нема експлицитног истека у АПИ-ју – Контактирајте свог менаџера налога за смернице животног циклуса токена
Периодично ротирајте токене ради сигурности

Токени оператера

– Истек је постављен када се захтева токен (параметар екпиресАт)

Потврдите токене пре употребе
Захтевајте нове токене пре истека

Примери имплементације

Питхон

import requests
from datetime import datetime, timedelta

class ChatHubAuth:
    def __init__(self, base_url):
        self.base_url = base_url
        self.company_token = None
        self.operator_tokens = {}

    def get_company_token(self, login, password):
        """Get company authentication token"""
        response = requests.post(
            f"{self.base_url}/api/company/get-token",
            json={"login": login, "password": password}
        )
        response.raise_for_status()
        self.company_token = response.json()
        return self.company_token

    def get_operator_token(self, operator_id, expires_days=30):
        """Get operator token with expiration"""
        expires_at = (
            datetime.utcnow() + timedelta(days=expires_days)
        ).isoformat() + "Z"

        response = requests.post(
            f"{self.base_url}/api/operator/get-token",
            headers={"Authorization": f"Bearer {self.company_token}"},
            json={"id": operator_id, "expiresAt": expires_at}
        )
        response.raise_for_status()

        token = response.json()
        self.operator_tokens[operator_id] = token
        return token

    def validate_token(self, token):
        """Validate if token is still valid"""
        response = requests.post(
            f"{self.base_url}/api/operator/validate-token",
            headers={"Authorization": f"Bearer {self.company_token}"},
            json={"token": token}
        )
        response.raise_for_status()
        return response.json()

# Usage
auth = ChatHubAuth("https://chatapi.smsbat.com")

# Get company token
company_token = auth.get_company_token("login", "password")

# Get operator token
operator_token = auth.get_operator_token(operator_id=123, expires_days=30)

# Validate token
is_valid = auth.validate_token(operator_token)
print(f"Token valid: {is_valid['valid']}")

ЈаваСцрипт (Ноде.јс)

const axios = require('axios');

class ChatHubAuth {
  constructor(baseUrl) {
    this.baseUrl = baseUrl;
    this.companyToken = null;
    this.operatorTokens = {};
  }

  async getCompanyToken(login, password) {
    const response = await axios.post(
      `${this.baseUrl}/api/company/get-token`,
      { login, password }
    );

    this.companyToken = response.data;
    return this.companyToken;
  }

  async getOperatorToken(operatorId, expiresDays = 30) {
    const expiresAt = new Date(
      Date.now() + expiresDays * 24 * 60 * 60 * 1000
    ).toISOString();

    const response = await axios.post(
      `${this.baseUrl}/api/operator/get-token`,
      { id: operatorId, expiresAt },
      {
        headers: {
          Authorization: `Bearer ${this.companyToken}`
        }
      }
    );

    const token = response.data;
    this.operatorTokens[operatorId] = token;
    return token;
  }

  async validateToken(token) {
    const response = await axios.post(
      `${this.baseUrl}/api/operator/validate-token`,
      { token },
      {
        headers: {
          Authorization: `Bearer ${this.companyToken}`
        }
      }
    );

    return response.data;
  }
}

// Usage
const auth = new ChatHubAuth('https://chatapi.smsbat.com');

async function authenticate() {
  // Get company token
  const companyToken = await auth.getCompanyToken('login', 'password');

  // Get operator token
  const operatorToken = await auth.getOperatorToken(123, 30);

  // Validate token
  const validation = await auth.validateToken(operatorToken);
  console.log('Token valid:', validation.isValid);
}

authenticate();

ПХП

<?php

class ChatHubAuth {
    private $baseUrl;
    private $companyToken;
    private $operatorTokens = [];

    public function __construct($baseUrl) {
        $this->baseUrl = $baseUrl;
    }

    public function getCompanyToken($login, $password) {
        $ch = curl_init($this->baseUrl . '/api/company/get-token');

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json'
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
            'login' => $login,
            'password' => $password
        ]));

        $response = curl_exec($ch);
        curl_close($ch);

        $this->companyToken = json_decode($response);
        return $this->companyToken;
    }

    public function getOperatorToken($operatorId, $expiresDays = 30) {
        $expiresAt = date(
            'Y-m-d\TH:i:s\Z',
            time() + ($expiresDays * 24 * 60 * 60)
        );

        $ch = curl_init($this->baseUrl . '/api/operator/get-token');

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json',
            'Authorization: Bearer ' . $this->companyToken
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
            'id' => $operatorId,
            'expiresAt' => $expiresAt
        ]));

        $response = curl_exec($ch);
        curl_close($ch);

        $token = json_decode($response);
        $this->operatorTokens[$operatorId] = $token;
        return $token;
    }

    public function validateToken($token) {
        $ch = curl_init($this->baseUrl . '/api/operator/validate-token');

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json',
            'Authorization: Bearer ' . $this->companyToken
        ]);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
            'token' => $token
        ]));

        $response = curl_exec($ch);
        curl_close($ch);

        return json_decode($response, true);
    }
}

// Usage
$auth = new ChatHubAuth('https://chatapi.smsbat.com');

// Get company token
$companyToken = $auth->getCompanyToken('login', 'password');

// Get operator token
$operatorToken = $auth->getOperatorToken(123, 30);

// Validate token
$validation = $auth->validateToken($operatorToken);
echo "Token valid: " . ($validation['isValid'] ? 'Yes' : 'No');

Најбоље праксе

Складиште токена

✅ Сигурно чувајте токене (шифрована база података, менаџер тајни)
✅ Никада не урезујте токене у контролу верзија
✅ Користите променљиве окружења за акредитиве
❌ Не чувајте токене у обичном тексту
❌ Немојте излагати токене у коду на страни клијента

Ротација токена

Периодично ротирајте токене компаније (сваких 3-6 месеци)
Подесите разуман рок трајања за токене оператера (7-30 дана)
Имплементирајте аутоматско освежавање токена пре истека
Опозовите токене када оператери оду

Обрада грешака

async function authenticateWithRetry(login, password, retries = 3) {
  for (let i = 0; i < retries; i++) {
    try {
      return await getCompanyToken(login, password);
    } catch (error) {
      if (error.response?.status === 401) {
        throw new Error('Invalid credentials');
      }

      if (i === retries - 1) throw error;

      // Wait before retry
      await new Promise(resolve =>
        setTimeout(resolve, Math.pow(2, i) * 1000)
      );
    }
  }
}

Валидација токена

Увек проверите токене пре критичних операција:

async function performSecureOperation(token, operation) {
  // Validate token first
  const validation = await validateToken(token);

  if (!validation.isValid) {
    throw new Error('Token expired or invalid');
  }

  // Proceed with operation
  return await operation();
}

Безбедносна разматрања

Само ХТТПС

Увек користите ХТТПС када шаљете захтеве за потврду идентитета:

// ✅ Correct
const baseUrl = 'https://chatapi.smsbat.com';

// ❌ Wrong - never use HTTP for authentication
const baseUrl = 'http://api.chathub.smsbat.com';

Токен Сцопе

Користите одговарајући токен за сваку операцију:

Токен компаније: управљање организацијом, креирање оператера
Токен оператера: операције ћаскања, руковање порукама

Ограничење брзине

Примените ограничење стопе за захтеве за аутентификацију:

class RateLimitedAuth {
  constructor() {
    this.lastRequest = 0;
    this.minInterval = 1000; // 1 second between requests
  }

  async getToken(login, password) {
    const now = Date.now();
    const timeSinceLastRequest = now - this.lastRequest;

    if (timeSinceLastRequest < this.minInterval) {
      await new Promise(resolve =>
        setTimeout(resolve, this.minInterval - timeSinceLastRequest)
      );
    }

    this.lastRequest = Date.now();
    return await makeAuthRequest(login, password);
  }
}

Решавање проблема

401 Неовлашћено

Проверите да ли су акредитиви тачни
Токен за проверу није истекао – Уверите се да је токен укључен у заглавља захтева
Потврдите формат токена

403 Забрањено

Проверите да токен има потребне дозволе
Проверите да ли користите исправан тип токена (компанија вс оператер)
Уверите се да токен није опозван

Токен је истекао

Захтевајте нови токен
Имплементирајте аутоматско освежавање токена
Подесите одговарајућа времена истека

Следећи кораци

Организације - Управљајте организацијама
Оператори - Рад са оператерима
Интеграција виџета - Интегришите виџет за ћаскање

Search Results

Аутхентицатион

Ток аутентификације

Токен компаније

Набавите токен компаније

Користите токен компаније

Метод 1: Заглавље ауторизације (препоручено)

Метод 2: Заглавље кључа Кс-Аутхоризатион-Кеи

Токен оператера

Набавите токен оператера

Користи токен оператера

Валидација токена

Истек токена

Токени компаније

Токени оператера

Примери имплементације

Питхон

ЈаваСцрипт (Ноде.јс)

ПХП

Најбоље праксе

Складиште токена

Ротација токена

Обрада грешака

Валидација токена

Безбедносна разматрања

Само ХТТПС

Токен Сцопе

Ограничење брзине

Решавање проблема

401 Неовлашћено

403 Забрањено

Токен је истекао

Следећи кораци