2021年5月9日 kintone API アップデート情報

API 更新情報

2021年5月9日に実施するメンテナンスにおける、kintone APIのアップデート内容は次のとおりです。

今月の kintone アップデート情報

5月版のスペーストップ画面のウィジェットを非表示に設定できる機能により、不要なウィジェットを非表示にしてオリジナルのコンテンツを表示させるカスタマイズが行えます。
また、これに伴い、一部のAPIやイベントにもウィジェットの非表示への対応が行われます。

kintone JavaScript API

機能追加

5月版でスペースの各ウィジェットを非表示に設定できます。それに伴い、以下の対応が行われます。

スペースのトップ画面の表示イベントの発行タイミングが、「すべてのウィジェットの描画完了後」から「すべての非表示ではないウィジェットの描画完了後」に変更されます
対象 API

スペースのトップ画面を表示した後のイベント - space.portal.show mobile.space.portal.show

備考

5月の定期メンテナンスで、スペースのトップ画面の各ウィジェットの表示設定(モバイルの場合はタブ)を変更できます。

機能改善

省略した形式の API のパスから URL を生成する JavaScript API で、指定したパスにかかわらず、必ず「.json」が付与されていた挙動を改善しました
対象 API
修正内容

kintone.api.url('/k/v1/records.json')の場合

変更前
https://example.cybozu.com/k/v1/record.json.json が生成される。
変更後
https://example.cybozu.com/k/v1/record.json が生成される。
今回の改善に関する影響

kintone.api.url('/k/v1/records')のように「.json」を省略してパスを指定している場合、今回の改善に対する影響はありません。
これらのAPIでは、本来「.json」が付くパスは指定できない仕様でした。
「.json」を付けたURLを指定すると、末尾にさらに「.json」が付与したURLを返していました。
今後は「.json」を付けたURLを指定した場合、新たに「.json」を付与することはなくなります。

これらのAPIを使って、「.json.json」といった末尾のURLを取得してREST APIを実行していないか、あらためて確認してください。

備考

この改善伴って、 kintone REST API リクエストを送信する APIでも、「.json」を付けたkintone REST APIのパスを指定して実行できます。
例:kintone.api('/k/v1/record.json', 'GET', ... )

kintone REST API

機能追加

5月版でスペースの各ウィジェットを非表示に設定できます。それに伴い、以下の対応が行われます。

スペース情報の取得 API にウィジェットの表示状態に関するパラメーターが追加されます

これらの表示状態は、「スペースのポータルと複数のスレッドを使用する」が有効のスペースでのみ取得できます。

対象 API

スペースの情報を取得する - /k/v1/space.json

備考

レスポンスパラメーターに以下のパラメーターが追加されます。

  • showAnnouncement:「お知らせ」の表示状態
  • showAppList:「アプリ一覧」の表示状態
  • showMemberList:「メンバー一覧」の表示状態
  • showThreadList:「スレッド一覧」の表示状態
  • showRelatedLinkList:「関連リンク一覧」の表示状態

製品のアップデート情報

API以外のkintoneのアップデートに関する情報は、 kintone アップデート情報 (External link) を参照してください。
5月定期メンテナンス分は後日公開されます。