Bắt đầu nhanh với HiTechPos API
Bắt đầu nhanh HiTechPos: tạo khoá API, lấy ID cửa hàng và gọi yêu cầu đầu tiên để liệt kê sản phẩm cùng đẩy một đơn hàng thử trong vài phút.
Hướng dẫn từng bước giúp bạn kết nối HiTechPos API: từ việc cấp API Key tới khi lấy được danh sách sản phẩm và tạo đơn hàng đầu tiên.
Bước 1: Tạo API Key
- Đăng nhập cổng quản trị HiTechPos tại
https://pos.hitechcloud.vn. - Vào Cấu hình → API & Tích hợp → API Key.
- Nhấn + Tạo API Key mới, đặt tên ứng dụng và chọn phạm vi cửa hàng áp dụng.
- Sao chép mã API Key (chỉ hiển thị một lần) và lưu trong biến môi trường.
API Key cho phép đọc và ghi dữ liệu bán hàng của bạn. Tuyệt đối không nhúng trong mã frontend (JavaScript, mobile) hay commit lên kho mã công khai.
Bước 2: Lấy danh sách cửa hàng
cURL lấy danh sách cửa hàng
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Phản hồi (200 OK)
{
"status": "success",
"data": [
{
"id": "shop_0a1b2c3d",
"name": "HiTech Store Quan 1",
"currency": "VND",
"timezone": "Asia/Ho_Chi_Minh",
"active": true
}
]
}Bước 3: Liệt kê sản phẩm của cửa hàng
cURL lấy danh sách sản phẩm
curl -X GET "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/products?page_number=1&page_size=20" \
-H "Authorization: Bearer YOUR_API_KEY"Lấy sản phẩm bằng Python
import os, requests
key = os.getenv("HITECHPOS_API_KEY")
shop = "shop_0a1b2c3d"
headers = {"Authorization": f"Bearer {key}"}
r = requests.get(
f"https://pos.hitechcloud.vn/api/v1/shops/{shop}/products",
headers=headers,
params={"page_number": 1, "page_size": 20},
)
for p in r.json()["data"]:
print(p["id"], p["name"], p["retail_price"])Bước 4: Tạo đơn hàng đầu tiên
cURL tạo đơn hàng
curl -X POST "https://pos.hitechcloud.vn/api/v1/shops/shop_0a1b2c3d/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"warehouse_id": "wh_main",
"items": [
{ "variation_id": "var_1001", "quantity": 2 }
],
"customer": { "name": "Nguyen Van A", "phone": "0901234567" },
"payment_method": "cash"
}'Nên thử toàn bộ các bước trên môi trường Sandbox (
pos-sandbox.hitechcloud.vn) trước khi chuyển sang Production.