Chuyển đến nội dung

Kết nối với REST API

Nơi tìm tài liệu tham chiếu API, cách xác thực, và các giới hạn cùng quy tắc mà mọi yêu cầu tuân theo.

4 phút đọc Màn hình thực tế, dữ liệu mẫu hư cấu Cập nhật 22 tháng 10 2026

REST API cho phép truy cập dữ liệu công ty của bạn bằng lập trình. API dành cho nhà phát triển xây dựng tích hợp; bạn không cần dùng đến trong công việc hằng ngày.

  • Tài liệu tham chiếu API: tài liệu tham chiếu đầy đủ được công khai tại /docs/api trên địa chỉ không gian làm việc của bạn, với tài liệu OpenAPI tại /docs/api/openapi.yaml và /docs/api/openapi.json. API & webhook trong Cài đặt có liên kết đến đó.
  • URL gốc: hiển thị ở đầu trang API & webhook. URL kết thúc bằng /api/v1.
  • Xác thực: gửi header Authorization: Bearer theo sau là token của bạn, và Accept: application/json.
  • Phản hồi: chỉ JSON. Bản ghi đơn lẻ được bọc trong data; danh sách thêm meta và links cho phân trang bằng con trỏ (tham số limit và cursor, tối đa 100 mỗi trang).
  • Thử lại an toàn: gửi header Idempotency-Key trên các yêu cầu POST. Lặp lại cùng yêu cầu với cùng khóa sẽ trả về phản hồi đã lưu thay vì tạo bản ghi thứ hai. Khóa được giữ trong 24 giờ.
  • Giới hạn tần suất: 120 yêu cầu mỗi phút cho mỗi token. Các header X-RateLimit-Limit và X-RateLimit-Remaining cho biết bạn đang ở mức nào; vượt giới hạn bạn sẽ nhận 429 kèm header Retry-After.

Yêu cầu có thể làm gì

Lệnh gọi chỉ thành công khi token có quyền (ví dụ invoices:write) và người dùng của token có quyền tương ứng trong ứng dụng. Các quy tắc nghiệp vụ giống như trên màn hình được áp dụng, nên hóa đơn đã phát hành cũng không thể sửa qua API.

Hỏi về sản phẩm

Hỏi phần mềm có thể làm gì, một công việc được thực hiện như thế nào, hoặc phần mềm hỗ trợ những quốc gia và ngôn ngữ nào. Câu trả lời lấy từ các bài hướng dẫn này.

Đang suy nghĩ…

Trợ lý AI hiện không khả dụng. Hãy tìm trong các hướng dẫn hoặc trao đổi với đội ngũ của chúng tôi. Liên hệ hỗ trợ

AI có thể mắc lỗi. Hãy kiểm tra các bài hướng dẫn được liên kết.

Vẫn cần hỗ trợ?

Đội hỗ trợ đọc mọi tin nhắn và trả lời bằng ngôn ngữ dễ hiểu.

Liên hệ hỗ trợ
Trò chuyện với AI