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.

Xem Markdown
  1. Đă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.
  2. 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.
  3. Gọi thử endpoint tra cứu doanh nghiệp (ví dụ bên dưới).
  4. Đọ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