SDK & Thư viện

SDK HiTechCloud Pay API: thư viện client mẫu và đoạn mã sẵn dùng để tích hợp truy vấn tài khoản, giao dịch và tài khoản ảo vào PHP, Node.js và Python.

Xem Markdown

HiTechCloud Pay API là REST thuần nên có thể gọi bằng bất kỳ ngôn ngữ nào. Dưới đây là các lớp bọc (wrapper) gọn nhẹ giúp bạn khởi động nhanh mà không cần cài thêm SDK nặng.

PHP — lớp client tối giản

HitechcloudPayClient.php
<?php
class HitechcloudPayClient {
    private string $base = 'https://userapi.hitechcloud.vn';
    public function __construct(private string $token) {}

    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->token}",
                "Accept: application/json",
            ],
        ]);
        $res = curl_exec($ch);
        curl_close($ch);
        return json_decode($res, true);
    }
}

$client = new HitechcloudPayClient(getenv('HITECHCLOUD_PAY_API_TOKEN'));
$accounts = $client->get('/v2/bank-accounts');
print_r($accounts['data']);

Node.js / TypeScript — lớp client tối giản

hitechcloud-pay.ts
export class HitechcloudPay {
  private base = "https://userapi.hitechcloud.vn";
  constructor(private token: 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.token}`, 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 pay = new HitechcloudPay(process.env.HITECHCLOUD_PAY_API_TOKEN!);
const txs = await pay.get("/v2/transactions", { page: 1, per_page: 50 });
console.log(txs);

Python — lớp client tối giản

hitechcloud_pay.py
import os, requests

class HitechcloudPay:
    BASE = "https://userapi.hitechcloud.vn"

    def __init__(self, token: str):
        self.session = requests.Session()
        self.session.headers.update({
            "Authorization": f"Bearer {token}",
            "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"]

pay = HitechcloudPay(os.environ["HITECHCLOUD_PAY_API_TOKEN"])
print(pay.get("/v2/bank-accounts"))
Các lớp client trên là mã nguồn mẫu để bạn sao chép và tùy biến. Nhớ giữ API Token trong biến môi trường và chỉ gọi API từ phía server.