2023年1月8日の定期メンテナンスの、API に関する情報をお知らせします。
お知らせの内容に追加、変更等ありましたら、こちらのコメント欄で変更箇所を追記します。
また、API ドキュメントは仕様を順次公開していきます。
kintone
API 関連のアップデートはありません。
kintone のアップデートに関する情報は、kintone アップデート情報を参照してください。
1月定期メンテナンス分は後日公開されます。
Garoon
API 関連のアップデートはありません。
クラウド版 Garoon のアップデートに関する情報は、クラウド版 Garoon 更新情報を参照してください。
1月定期メンテナンス分は後日公開されます。
cybozu.com 共通管理
API 関連のアップデートはありません。
cybozu.com のアップデートに関する情報は、各サービスのアップデート情報を参照してください。
1月定期メンテナンス分は後日公開されます。
※ ページ上部の「API 更新情報のお知らせをメールで受け取る」ボタンから、毎月の API 更新情報をメールで受け取ることができます。
こんにちは。
2022/12/19頃から「先行動作確認環境」でkintoneからのレスポンスが変わったため、質問させてください。
「日付」というフィールドコードに対して、誤った日付書式をクエリに指定しリクエストをした際に、エラーが返ってくることを確認しているのですが、2022/12/19頃からエラーメッセージが変わりました。
レスポンスの仕様が変更されたのでしょうか?
(もしくは、意図せず変わってしまっているのでしょうか?)
以下に詳細を記載します。よろしくお願いいたします。
■リクエスト
/k/v1/records.json?app=15&query=%E6%97%A5%E4%BB%98%3D%2220221226%22 (後略)
(query部分は「日付="20221226"」をURLエンコードした文字列です。)
■エラーメッセージ(2022/12/19以前)
フィールド「日付」に指定した20221226-01-01の日付書式が不正です。
■エラーメッセージ(2022/12/19以降)
フィールド「日付」に指定した+20221226-01-01の日付書式が不正です。
※エラーメッセージの差異は、"+"が増えたことです。
なお、当記事へコメントした理由は、下記2点から2023/01/08 の定期メンテナンスに係わりがありそうと考えたためです。
HONMA 様
お世話になっております。cybozu developer network 運営チームです。
先行動作確認環境での動作について、フィードバックいただきありがとうございます。
社内に情報連携して調査中です。
よろしければ、参考までにお伺いさせてください。
本件のエラーメッセージが変わることによるお客様への影響はどのような状況でしょうか。
お返事をありがとうございます。
社内で調査中途のこと、よろしくお願いいたします。
さて、質問へ回答いたします。
影響はとても軽微です。
エラーが返ってくることを検証するテストコードがありまして、そのテストコードを修正する程度です。
補足情報として、質問させていただいた背景をお伝えします。
・エラーメッセージの変わり方を不可解に感じておりまして、修正意図が分からず不安です。
・今回はエラーメッセージが変わっていることに気づくことができましたが、他にも変わっている箇所があるのか分からず不安です。(「API関連のアップデートはありません」とアナウンスされていますが、実際変わっているため。)
・同じような現象に遭遇している方から、何かしら情報をいただけるのではないかと期待しています。
HONMA 様
ご回答ありがとうございます。
今回ご連絡いただきました内容は、開発チームへ情報連携しました。
なお API のアップデートについては、API ドキュメントに記載されている範囲でお知らせしています。
記載のない範囲についてはアップデートで変更される可能性がございます。
今後ともよろしくお願いいたします。
ご回答ありがとうございます。
・APIドキュメントに記載のない範囲がアップデートで変更される可能性があることは、承知しております。
・そのため、ポリシーを感じる変更であれば気にせず受け入れるスタンスです。
・ただ今回は変更内容が不可解であったため、意図された通りのメッセージなのかを問い合わせさせていただきました。(実害は小さいのですが、不安が大きいです)
またお気づきかもしれませんが、追加情報をお伝えします。
入力値によってエラーメッセージに「+」が付いたり付かなかったりしています。
入力値: "12345678"
→ フィールド「日付」に指定した+12345678-01-01の日付書式が不正です。
入力値: "1234567890"
→ フィールド「日付」に指定した1234567890の日付書式が不正です。
入力値: "abc"
→ フィールド「日付」に指定したabcの日付書式が不正です。
開発チームへ連携いただけているとのこと、ありがとうございます。
何かしら分かりましたら、お返事いただけると嬉しいです。