Quickstart
Bốn bước để gọi API Tools của HiTechCloud lần đầu: tạo tổ chức, lấy khoá API, gọi endpoint tra cứu và đọc phản hồi JSON, kèm mã mẫu cURL.
- Đăng nhập Cổng khách hàng bằng HiTechCloud ID. Lần đầu bạn tạo một tổ chức — mọi khoá và hạn mức thuộc về tổ chức.
- Vào mục Khoá API và tạo khoá. Khoá chỉ hiện đúng một lần: sao chép và cất vào biến môi trường ngay.
- Gọi thử endpoint tra cứu doanh nghiệp (ví dụ bên dưới).
- Đọc phản hồi, rồi xem Mã lỗi để xử lý các trường hợp 401, 404, 429.
Gọi endpoint đầu tiên
cURL
export HITECH_API_KEY="<khoá của bạn>"
curl 'https://api-tools.hitechcloud.vn/api/tax/business/0316954486' \
-H "X-API-Key: $HITECH_API_KEY" \
-H 'Accept: application/json'Phản hồi mẫu
json
{
"ok": true,
"mst": "0316954486",
"ten": "CÔNG TY TNHH HITECH CLOUD",
"trang_thai": "Đang hoạt động",
"nguon": "gdt.gov.vn",
"cached_at": "2026-10-31T09:00:00+07:00"
}Chưa muốn viết code? Dùng thẳng mục Công cụ trong Cổng khách hàng — bạn tra cứu được ngay mà không cần nhập khoá.
Bước tiếp theo
- Duyệt API Reference và bấm Thử ngay trên từng endpoint.
- Cài SDK & CLI hoặc kết nối MCP cho trợ lý AI.
- Đặt webhook để nhận cảnh báo hạn mức.