SDK & Thư viện

SDK HiTechCloud Sale AI: mẫu khởi tạo client và gọi API cho Node.js, PHP và Python, giúp tích hợp chatbot bán hàng vào ứng dụng nhanh hơn.

Xem Markdown

Bạn có thể gọi API bằng bất kỳ HTTP client nào. Dưới đây là các mẫu khởi tạo nhanh. SDK chính thức đóng gói sẵn xác thực, phân trang và retry theo rate limit.

Node.js

Khởi tạo client Node.js
const BASE = "https://sale-ai.hitechcloud.vn/api/v1";
const token = process.env.SALE_AI_TOKEN;

async function listBots() {
  const res = await fetch(`${BASE}/bots`, {
    headers: { Authorization: `Bearer ${token}` },
  });
  const body = await res.json();
  return body.data;
}

PHP

Gửi tin bằng PHP (cURL)
<?php
$base = "https://sale-ai.hitechcloud.vn/api/v1";
$ch = curl_init("$base/bots/bot_7c1a9f2e/messages");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("SALE_AI_TOKEN"),
    "X-Page-Access-Token: " . getenv("PAGE_ACCESS_TOKEN"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "subscriber_id" => "sub_2a9b8c7d",
    "type" => "text",
    "text" => "Xin chao!",
  ]),
]);
$response = curl_exec($ch);
echo $response;

Python

Duyệt phân trang bằng Python
import os, requests

BASE = "https://sale-ai.hitechcloud.vn/api/v1"
headers = {"Authorization": f"Bearer {os.getenv('SALE_AI_TOKEN')}"}

def all_subscribers(bot_id):
    page = 1
    while True:
        r = requests.get(f"{BASE}/subscribers", headers=headers,
                         params={"bot_id": bot_id, "page": page, "per_page": 100})
        body = r.json()
        yield from body["data"]
        if not body["meta"]["pagination"]["has_more"]:
            break
        page += 1
SDK chính thức tự động thử lại khi gặp 429 và 503 theo header Retry-After. Khi tự viết client, hãy tự xử lý backoff.