Phiên bản API

Khi bạn đã tích hợp xong, code của bạn không được phép hỏng chỉ vì Hensa cập nhật. Vì vậy:

Thay đổi không phá vỡ – có thể đến bất cứ lúc nào

• Thêm endpoint mới, thêm trường mới vào phản hồi, thêm giá trị mới vào enum, thêm loại sự kiện mới.
• → Code của bạn phải bỏ qua trường lạ và xử lý mềm giá trị enum chưa biết.

Thay đổi phá vỡ – chỉ qua phiên bản mới

Đổi tên/xóa trường, đổi ý nghĩa, đổi định dạng → phát hành dưới một phiên bản theo ngày mới (vd. 2027-03-01). Khóa API của bạn được ghim vào phiên bản tại thời điểm tạo; bạn chủ động nâng cấp khi sẵn sàng:

curl https://api.hensa.example/v1/payment_requests/prq_01JD7Q8M4K2X9V3T6B5N0R1W8Y \
  -H "Authorization: Bearer $HENSA_API_KEY" \
  -H "Hensa-Version: 2026-11-01"

• Phiên bản cũ được hỗ trợ ít nhất 12 tháng sau khi có phiên bản mới, kèm email nhắc trước.
• Mỗi phiên bản có hướng dẫn nâng cấp trong Changelog.

Phiên bản hiện tại: 2026-11-01 (Beta).