スペースのスレッド内コメントの投稿

スペースIDとスレッドIDを指定してスレッドのコメントを投稿できます。

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

HTTP メソッド

POST

URI

https://{subdomain}.cybozu.com/k/v1/space/thread/comment.json

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

https://{subdomain}.cybozu.com/k/guest/{spaceId}/v1/space/thread/comment.json

アクセス権

非公開スペース・ゲストスペースの場合、スペース参加者のみ実行可能。

リクエストパラメータ

パラメータ名	指定する値	必須	説明
space	数値又は文字列	必須	スペースのIDを指定します。
thread	数値又は文字列	必須	スレッドIDを指定します。
comment	オブジェクト	必須	コメントの情報です。投稿時の内容は下記の順で構成されます。 comment.mentions[]で指定されるメンションの情報 comment.textで指定されるコメント内容 comment.files[]で指定される添付ファイル
comment.text	文字列	条件必須	コメントの内容です。改行はLFで指定できます。コメントの最大文字数は65535文字です。 comment.text と comment.files いずれかが必須になります。
comment.mentions	配列		メンションの宛先情報です。
comment.mentions[].code	文字列		メンション先のユーザー・組織・グループコードです。指定できるメンション数の上限値は10です。メンションを指定すると、本文の前にメンションが挿入されます。
comment.mentions[].type	文字列		メンション先のユーザー・組織・グループの種類です。 USER：ユーザー GROUP：グループ ORGANIZATION：組織
comment.files	配列	条件必須	添付ファイルの配列です。最大5つまでです。 comment.text と comment.files いずれかが必須になります。
comment.files[].fileKey	文字列		添付するファイルのキーです。ファイルアップロードのキーを利用できます。
comment.files[].width	数値又は文字列		添付ファイルが画像の場合に画像が表示される幅を指定できます。最小100、最大750です。省略時にはオリジナルの幅(画面から投稿時に「元のサイズ」を選択したときと同じ幅)で表示されます。画像以外で指定した場合、無視されます。

※各IDはブラウザのアドレスをご確認ください。
　https://{subdomain}.cybozu.com/k/#/space/250/thread/1026 の場合、スペースIDは「250」、スレッドIDは「1026」です。

リクエストの例

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

POST /k/v1/space/thread/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

制限事項

制限事項をご確認ください。