Gọi API đầu tiên

Trong vài phút bạn có thể gọi thử API: tạo một khoá, rồi lấy danh sách hoá đơn bằng cURL.

Bước 1: Tạo khoá

Trong ứng dụng, mở Hệ thống, thẻ API và Webhook, chọn Tạo API key (hướng dẫn). Chọn quyền xem hoá đơn. Sao chép khoá ngay vì nó chỉ hiển thị một lần.

Lưu khoá vào biến môi trường:

export HOADON_API_KEY="hd_test_xxxxxxxxxxxxxxxxxxxxxx"

Bước 2: Lấy danh sách hoá đơn

curl "https://api.hoadon.pro/v1/invoices?limit=5" \
  -H "Authorization: Bearer $HOADON_API_KEY"

Phản hồi là một đối tượng có data (mảng hoá đơn) và next_cursor (xem Phân trang):

{
  "data": [],
  "next_cursor": null
}

Đường dẫn chính xác và các trường của hoá đơn xem ở Scalar; ví dụ trên dùng đường dẫn minh hoạ cho tới khi đặc tả được công bố.

Bước 3: Lọc theo tổ chức

Thêm org_id để chỉ lấy dữ liệu của một tổ chức; có thể lặp lại tham số để chọn nhiều tổ chức:

curl "https://api.hoadon.pro/v1/invoices?limit=5&org_id=ORG_ID_1&org_id=ORG_ID_2" \
  -H "Authorization: Bearer $HOADON_API_KEY"

Tiếp theo

• Xác thực và quyền của khoá.
• Lỗi: cách đọc phản hồi lỗi.
• Webhook: nhận hoá đơn mới theo thời gian thực.