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.
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 += 1SDK 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.