Đang tải bảng tin…
API Evangelist0 Hot0 bình luận4 phút đọc
OpenAPI Overlays for Translating and Localizing One Canonical Spec
Maintaining separate translated copies of an OpenAPI spec leads to contract drift and inconsistency. OpenAPI Overlays solve this by treating translation as a presentation concern rather than a contract concern. One canonical English spec is kept as the source of truth, while per-language overlay files replace only human-readable fields like summaries, descriptions, and error message examples. A concrete Spanish overlay example demonstrates translating both endpoint summaries and Problem Details error responses while leaving contract elements (paths, header names, media types) untouched. The recommended folder structure is locale-first (overlays/es/, overlays/de/) with a build pipeline that generates localized specs on demand. The core argument: any team maintaining multiple copies of an OpenAPI file for different languages has already introduced a second source of truth and will eventually pay for it.
Nguồn: https://apievangelist.com/2026/07/09/openapi-overlays-for-translating-and-localizing. 8sync News chỉ tóm tắt và dẫn link; bản quyền nội dung thuộc tác giả và nguồn gốc.
Đề xuất cho bạn
InfoQ1 Hot4 phútAI
AlloyDB Ships Proxy Models That Replace LLM Calls with Local Inference Inside the Database
Google giới thiệu AlloyDB AI functions với hai kỹ thuật tăng tốc cho truy vấn SQL sử dụng LLM: smart batching (gọi model theo lô, đạt 10.000 rows/giây) và kiến trúc proxy model (huấn luyện model nhẹ trong database bằng PREPARE, chạy nội bộ tới 100.000 rows/giây, giảm 6.000 lần chi phí). Proxy model hiện ở chế độ preview cho ai.if, bổ sung thêm các hàm ai.summarize, ai.agg_summarize, ai.analyze_sentiment cùng MCP server quản lý cho AI agent. Các số liệu benchmark từ thử nghiệm nội bộ cần được xác thực thêm trước khi triển khai sản xuất.
