SDK & Thư viện
SDK HiTechPos: thư viện client mẫu và đoạn mã sẵn dùng để tích hợp API bán hàng đa kênh vào PHP, Node.js và Python.
HiTechPos API là REST thuần nên gọi được bằng mọi ngôn ngữ. Dưới đây là các lớp bọc (wrapper) gọn nhẹ để bạn khởi động nhanh.
PHP — lớp client tối giản
HitechPosClient.php
<?php
class HitechPosClient {
private string $base = 'https://pos.hitechcloud.vn/api/v1';
public function __construct(private string $key) {}
public function get(string $path, array $query = []): array {
$url = $this->base . $path . (empty($query) ? '' : '?' . http_build_query($query));
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer {$this->key}",
"Accept: application/json",
],
]);
$res = curl_exec($ch);
curl_close($ch);
return json_decode($res, true);
}
}
$client = new HitechPosClient(getenv('HITECHPOS_API_KEY'));
$products = $client->get('/shops/shop_0a1b2c3d/products', ['page_size' => 50]);
print_r($products['data']);Node.js / TypeScript — lớp client tối giản
hitechpos.ts
export class HitechPos {
private base = "https://pos.hitechcloud.vn/api/v1";
constructor(private key: string) {}
async get<T = unknown>(path: string, query: Record<string, string | number> = {}): Promise<T> {
const qs = new URLSearchParams(
Object.entries(query).map(([k, v]) => [k, String(v)]),
).toString();
const url = `${this.base}${path}${qs ? "?" + qs : ""}`;
const res = await fetch(url, {
headers: { Authorization: `Bearer ${this.key}`, Accept: "application/json" },
});
const body = await res.json();
if (body.status === "error") throw new Error(`[${body.code}] ${body.message}`);
return body.data as T;
}
}
const pos = new HitechPos(process.env.HITECHPOS_API_KEY!);
const orders = await pos.get("/shops/shop_0a1b2c3d/orders", { page_size: 50 });
console.log(orders);Python — lớp client tối giản
hitechpos.py
import os, requests
class HitechPos:
BASE = "https://pos.hitechcloud.vn/api/v1"
def __init__(self, key: str):
self.session = requests.Session()
self.session.headers.update({
"Authorization": f"Bearer {key}",
"Accept": "application/json",
})
def get(self, path: str, **params):
r = self.session.get(f"{self.BASE}{path}", params=params)
body = r.json()
if body.get("status") == "error":
raise RuntimeError(f"[{body['code']}] {body['message']}")
return body["data"]
pos = HitechPos(os.environ["HITECHPOS_API_KEY"])
print(pos.get("/shops/shop_0a1b2c3d/products", page_size=50))Bắt đầu nhanhCấp API Key và gọi API đầu tiên.Tạo đơn hàngĐẩy đơn và trừ kho tự động.WebhookNhận sự kiện theo thời gian thực.
Các lớp client trên là mã mẫu để bạn sao chép và tuỳ biến. Nhớ giữ API Key trong biến môi trường và chỉ gọi API từ phía server.