HƯỚNG DẪN CHUẨN BỊ TÍCH HỢP API ZBS — by Brotech

1. Khảo sát hệ thống nguồn
Phần mềm nào quản lý đơn/lịch/khách? Có API hoặc webhook không?
Ai quản lý quyền truy cập? Có môi trường thử nghiệm không?

2. Lập bảng ánh xạ
Tên biến mẫu | Trường nguồn | Kiểu dữ liệu | Ví dụ | Bắt buộc | Xử lý khi thiếu
Không điền khóa truy cập hay thông tin cá nhân thật vào tài liệu chia sẻ.

3. Thiết kế sự kiện
Sự kiện nào kích hoạt gửi? Khi nào sự kiện được xác nhận?
Dùng mã sự kiện/mã đơn để chống trùng; thống nhất điều kiện gửi trước khi kết nối.

4. Bảo vệ và vận hành
Giữ khóa truy cập phía máy chủ, giới hạn quyền và che dữ liệu nhạy cảm trong log.
Thống nhất timeout, retry có giới hạn và hàng đợi xử lý lỗi.
Không gửi lại vô hạn; kiểm tra trạng thái trước khi thử lại.

5. Nghiệm thu
Thử trường hợp thành công, dữ liệu thiếu, sự kiện trùng, lỗi kết nối và thay đổi trạng thái.
Đối chiếu số sự kiện nguồn với yêu cầu gửi, kết quả và chi phí.

Endpoint, xác thực, giới hạn và cấu trúc phản hồi cần được xác nhận từ tài liệu chính thức của nền tảng và hệ thống nguồn đang sử dụng. Đây là tài liệu chuẩn bị, không phải đặc tả API chính thức.