Phiên bản

Phiên bản API 2026-10-affable-towhee

API của Lingara được đặt phiên bản theo tên, có dạng yyyy-mm-adjective-noun. Phần /v1 trong mỗi đường dẫn không bao giờ thay đổi: chính phiên bản quyết định một lệnh gọi nhận gì và trả về gì.

Phiên bản của ứng dụng khách

Một ứng dụng khách được ghim vào phiên bản hiện hành khi nó được tạo, và lệnh gọi dùng bất kỳ token truy cập nào của nó mà không có header phiên bản sẽ được trả lời theo phiên bản đó. Chủ sở hữu ứng dụng khách có thể ghim lại nó vào một phiên bản được hỗ trợ khác trên trang Tích hợp, tại app.getlingara.com/admin; các token truy cập của nó dùng phiên bản mới từ lần đổi tiếp theo.

Phiên bản cho một lệnh gọi

Gửi Lingara-Version: <id> kèm lệnh gọi để dùng phiên bản đó thay cho phiên bản đã ghim; phản hồi cho biết phiên bản đã dùng. Phiên bản phát triển chỉ có thể truy cập theo cách này và có thể thay đổi mà không báo trước.

Vòng đời của một phiên bản

Phiên bản có thể ghim là supported, và phiên bản được duy trì lâu hơn là lts. Phiên bản deprecated vẫn trả lời, kèm các header Deprecation và Sunset trong mọi phản hồi, và chỉ kết thúc ít nhất 90 ngày sau khi bị ngừng khuyến nghị. Phiên bản discontinued bị từ chối với 410 và mã api_version_discontinued.

Các phiên bản đã phát hành

Nếu bản dịch và tài liệu tham chiếu tiếng Anh khác nhau, tài liệu tham chiếu tiếng Anh là bản đúng.