Bắt đầu nhanh
Tích hợp bất kỳ API nào của HiTechCloud trong ba bước: chọn sản phẩm, lấy khoá API hoặc access token, rồi gửi yêu cầu đầu tiên tới môi trường thử nghiệm.
Bước 1 — Chọn sản phẩm
Mỗi sản phẩm có base URL và bộ endpoint riêng. Mở trang Tổng quan của sản phẩm bạn cần (xem Giới thiệu) để biết base URL Production/Sandbox.
Bước 2 — Lấy khoá xác thực
Tạo khoá API hoặc Bearer token trong Developer Console. Giữ khoá bí mật, chỉ gửi qua HTTPS ở phía máy chủ. Chi tiết: Xác thực.
Bước 3 — Gọi request đầu tiên
Gửi request kèm header xác thực tới host của sản phẩm. Hai ví dụ dưới dùng Bearer token; API Tools thì thay bằng header X-API-Key.
cURL
curl -s "https://<product-host>.hitechcloud.vn/api/v1/<endpoint>" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Accept: application/json"Node.js (fetch)
const res = await fetch(
"https://<product-host>.hitechcloud.vn/api/v1/<endpoint>",
{ headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}`, Accept: "application/json" } },
);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();Host theo sản phẩm
- API Tools —
https://api-tools.hitechcloud.vn(headerX-API-Key) - HiTechCloud Pay —
https://pay.hitechcloud.vn(Bearer) - HiTechCloud ID / IAM —
https://iam.hitechcloud.vn/api/v1(OAuth2 / OIDC) - Các sản phẩm khác (eKYC, Omnichannel, POS, CRM, WAF, Sale AI, Hoá đơn, Loa, BankHub): xem host Production/Sandbox trong trang Tổng quan của sản phẩm.
Bước 4 — Bắt sự kiện webhook (tuỳ chọn)
Nhiều sản phẩm gọi ngược về URL của bạn khi có sự kiện (thanh toán, biến động số dư…). Đăng ký endpoint trong Developer Console rồi xác minh chữ ký HMAC trước khi xử lý — xem Xác thực → HMAC webhook.
Tất cả endpoint đều chạy được trong Sandbox trước khi lên Production — xem Môi trường thử nghiệm. Cần đặc tả máy đọc? Mở API gốc (OpenAPI).