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.

Xem Markdown

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))
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.