レコードコメントの投稿

アプリIDとレコードIDを指定してレコードにコメントを投稿できます。

APIトークンを利用した場合、投稿ユーザーは「Administrator」になります。
メンションの名前は投稿ユーザーの言語設定が利用されます。
停止ユーザー、削除ユーザー・組織・グループには通知されません。
ゲストスペースの場合、退会したユーザーは削除ユーザーと同じ動作になります。
招待中のゲストユーザーにメンションを指定するとエラーになります。
レコードのコメント機能が無効な場合に実行するとエラーになります。

HTTP メソッド

POST

URI

https://(サブドメイン名).cybozu.com/k/v1/record/comment.json

ゲストスペース内のアプリの場合

https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/record/comment.json

必要なアクセス権

コメントを投稿するアプリの閲覧権限
コメントを投稿するレコードの閲覧権限

リクエストパラメータ

パラメータ名	指定する値	必須	説明
app	数値又は文字列	必須	アプリのIDを指定します。
record	数値又は文字列	必須	レコードIDを指定します。
comment	オブジェクト	必須	コメントの情報です。
comment.text	文字列	必須	コメントの内容です。コメントの最大文字数は65535文字です。
comment.mentions	配列		メンションの宛先情報です。
comment.mentions[].code	文字列		メンション先のユーザー・組織・グループコードです。指定できるメンション数の上限値は10です。メンションを指定すると、本文の前にメンションが挿入されます。
comment.mentions[].type	文字列		メンション先のユーザー・組織・グループの種類です。 USER：ユーザー GROUP：グループ ORGANIZATION：組織

リクエストの例

リクエストヘッダを含んだ文字列

POST /k/v1/record/comment.json HTTP/1.1
Host: example.cybozu.com:443
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

Content-Type に application/json を指定して下さい。指定しない場合は JSON が解釈できないため、実行時エラーとなります。

ボディ

レスポンス

投稿したコメントのIDが返されます。

JavaScriptサンプル

kintone REST API

XMLHttpRequest

APIトークンで投稿した例

制限事項

共通仕様の制限事項をご確認ください。