kintone API更新與提供政策

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

概述

本文說明了關於kintone API(以下簡稱API) 的更新與提供方針
所謂API的更新,係指本網站上API文件中所記載的API規格的變更或刪除,及新增 API。
此外,還介紹更新API時提前公告的資訊,以及“更新選項”的使用。“更新選項”可讓開發者提前試用將要發布的功能,以便提前修改受影響的程式。
本文旨在幫助參與API程式開發與維運的各位,能更容易掌握API更新所需的因應措施,並藉此協助您提供更穩定的服務。

API更新的基本方針

我們為了提供更優質的服務,會持續對kintone進行更新。

對於API,我們會在盡可能維持相容性的前提下進行更新。
但是,當認為有必要改進產品或降低安全風險時,我們可能會更新現有的API規範或廢除它。

更新內容的事前公告

kintone在每月的第二個星期日進行定期維護。
若在定期維護時釋出API更新至月度通道,將於維護的4週前,在以下頁面公告:
API更新資訊(日語)

若預期更新內容可能造成較高的調整成本,或需要一定的準備期間,則會提前公告。
但是,在修復高度緊急的漏洞或缺陷時,我們可能不會提前通知。
此外,更新選項(詳細資訊將在後面描述)中提供的API更新如預設停用時,我們不會在提供時提前通知。

使用更新選項功能

根據API更新的內容(相容性、變更範圍等),部分更新可能會納入「更新選項」功能。
更新選項可讓您切換更新功能的「啟用」/「停用」狀態。
kintone 透過此功能,允許您「在正式釋出前預先測試即將推出的新功能」,以及「在釋出後暫時停用新功能,以重現更新前的環境」。
如需更新選項的詳細資訊,請查看下列說明頁面:
在「更新選項」畫面上可進行的操作 (External link)

預先試用預定釋出的新功能

如即將釋出的API更新影響較大,例如需要事先驗證和對您的程式進行修改,我們將其納入“預先試用預定釋出的新功能”的更新選項。

此類更新可在正式釋出前啟用運行。
透過此選項,開發者可在更新正式上線前進行動作驗證或程式修改。
若屬於提前使用的對象,API的規格與使用期間等詳細資訊將會公告於以下頁面:
API更新資訊 (日語)

提前使用期間,我們會關注基於先前規範的API是否可繼續使用,並根據需要做適當調整。
若期間內出現需追加說明的事項,也會在同一頁面迅速公告。

停用新功能

部分API更新可能會納入「停用新功能」的更新選項。
此類更新可在釋出後暫時停用。
透過此選項,例如在API更新後發現程式行為出現變化時,可以暫時避開問題,或爭取額外的程式修正時間。
原則上,會提供至少3個月以上的可停用期間。