變更紀錄

這一頁記錄對外介面的變動。API 版本是日期版號，值看回應標頭 X-Sfapp-Api-Version 或 GET /v1/me 的 api_version。相容承諾見 請求慣例。

2026-09-14 起提供下列介面。

• 身分端點 GET /v1/me。
• 文章的列出、建立、讀取、更新、發布、下架與二段式刪除。
• 分類的列出與建立。
• 圖片的上傳與刪除。
• 稽核事件查詢 GET /v1/audit/events。
• 權限範圍 read_blog、write_blog、publish_blog、write_media、read_audit。
• 固定格式的錯誤回應與 24 個錯誤碼。
• 游標分頁。
• Idempotency-Key 冪等與十分鐘內容去重。
• 讀寫分開的每分鐘限流與每日配額。
• 機器可讀規格 GET /v1/openapi.json。

下列項目尚未提供，形態可能調整。上線時會列在這一頁，並遵守既有的相容承諾。

• 分類的更名、搬移與刪除。
• 清除文章封面圖。
• 商品與訂單相關的端點。
• 事件推播，免輪詢即可得知內容變動。
• 依發布時間排序與更多列表篩選條件。