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 月定期メンテナンス分は後日公開されます。