Changelog API

Tất cả phản hồi v1 hiện bao gồm header X-API-Version: 1.0.0. Máy khách có thể sử dụng header này để xác minh phiên bản API nào phục vụ phản hồi và triển khai logic nhận biết phiên bản trong tích hợp của họ.

Các endpoint giờ đây có thể báo hiệu deprecation qua các header Deprecation, Sunset và Link tuân thủ RFC 8594. Khi một endpoint được lên lịch xóa, header Deprecation chỉ ra ngày deprecation, header Sunset báo hiệu ngày xóa và header Link trỏ đến tài liệu endpoint thay thế.

Tất cả các phản hồi lỗi giờ đây đều trả về một cấu trúc nhất quán dạng { ok: false, error, code?, status }. Cấu trúc cũ { error } không còn được khuyến nghị và sẽ bị loại bỏ trong một phiên bản tương lai. Các phản hồi thành công tiếp tục trả về { ok: true, data, ... }. Việc hợp nhất này đơn giản hóa việc xử lý lỗi phía máy khách trên tất cả 83 điểm cuối.

Ra mắt API dành cho nhà phát triển của akousa.net với 83 điểm cuối trên 17 nhóm, một đặc tả OpenAPI 3.1 hoàn chỉnh, quyền truy cập API được bao gồm trong Akousa Pro, xác thực khóa API sử dụng tiền tố ak_, và giới hạn tốc độ với hạn mức hằng ngày theo từng bậc. Tài liệu tương tác kèm ví dụ mã bằng 8 ngôn ngữ (cURL, JavaScript, Python, Go, PHP, Ruby, Java, C#).