Ngừng hỗ trợ
Chính sách ngừng hỗ trợ của API công khai — báo trước ít nhất sáu tháng, các header Deprecation, Sunset và Link, và danh sách thao tác đang ngừng hỗ trợ.
Chính sách
Một thao tác công khai không biến mất đột ngột. Trước khi gỡ, AgentFlow đánh dấu nó là ngừng hỗ trợ (deprecated) và báo trước ít nhất 6 tháng (183 ngày). Việc gỡ chỉ xảy ra ở một phiên bản chính mới — xem Tổng quan API.
Nhận biết một thao tác đang ngừng hỗ trợ
Mọi phản hồi của thao tác đó, kể cả phản hồi lỗi, mang ba header:
Deprecation: @<thời điểm công bố, giây Unix>
Sunset: <ngày sớm nhất có thể gỡ, dạng HTTP-date>
Link: </guides/api/ngung-ho-tro/#<operation_id>>; rel="deprecation"| Header | Nội dung |
|---|---|
Deprecation | Dấu @ và thời điểm công bố ngừng hỗ trợ, tính bằng giây Unix (RFC 9745). |
Sunset | Ngày sớm nhất thao tác có thể bị gỡ, dạng HTTP-date (RFC 8594). |
Link | Mục của thao tác đó trên trang này, với rel="deprecation". Đường dẫn tính từ địa chỉ bản triển khai. |
Trong tài liệu API, thao tác đó mang deprecated: true, cùng hai trường:
x-deprecated-at— ngày công bố ngừng hỗ trợ;x-sunset— ngày sớm nhất có thể gỡ.
Hãy để tích hợp của bạn ghi log mỗi khi một phản hồi mang header Deprecation. Như vậy bạn biết sớm, thay vì biết vào ngày thao tác bị gỡ.
Các thao tác đang ngừng hỗ trợ
Hiện không có thao tác nào đang ngừng hỗ trợ.
Khi có, mỗi thao tác sẽ có một mục riêng ở đây, với tiêu đề đúng bằng operation id của nó, để header Link trỏ thẳng tới #<operation_id>.