# 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.

_Nguồn: https://developers.hitechcloud.vn/tai-lieu/quickstart · Tài liệu HiTechCloud Developers_

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](/tai-lieu/ma-loi) để xử lý các trường hợp 401, 404, 429.

## Gọi endpoint đầu tiên

**cURL**

```bash
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](/tai-lieu/reference) và bấm **Thử ngay** trên từng endpoint.
- Cài [SDK & CLI](/tai-lieu/sdk) hoặc [kết nối MCP](/tai-lieu/mcp) cho trợ lý AI.
- Đặt [webhook](/tai-lieu/webhooks) để nhận cảnh báo hạn mức.
