將回覆貼文到記錄中。
- 如果您使用 API 權杖,則貼文使用者將是「Administrator」。
- 目標的名稱基於運行 API 的使用者的語言設置。
- 暫停的使用者、已刪除的用戶、組織和組不會收到通知。
- 對於訪客空間,離開組的使用者將具有與已刪除使用者相同的行為。
- 如果將受邀的來賓使用者指定為目標,則會發生錯誤。
- 如果您在禁用記錄回覆的應用程式中運行它,則會出現錯誤。
- 常規應用程式
- https://sample.cybozu.com/k/v1/record/comment.json
- 訪客空間的應用程式
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/record/comment.json
POST
- 查看發表回覆的應用的許可權
- 查看發表回覆的記錄的許可權
參數
參數名稱 |
類型 |
必須 |
說明 |
app |
數值或字串 |
必須 |
應用ID |
record |
數值或字串 |
必須 |
記錄ID |
comment |
物件 |
必須 |
回覆內容 |
comment.text |
字串 |
必須 |
回覆內容 回覆的最大長度為 65,535 個字元。 |
comment.mentions |
陣列 |
可省略 |
回覆的收件人資訊 |
comment.mentions[].code |
字串 |
可省略 |
目標使用者/組織/群組代碼。 可以指定的最大目標數為 10。 指定目標時,目標資訊將插入到內文之前。 如果要指定訪客作為目標使用者,則需要在代碼中指定「guest/登錄電子郵件位址」。 |
comment.mentions[].type |
字串 |
可省略 |
它所指向的使用者/組織/群組的類型。USER :使用者GROUP :群組ORGANIZATION :組織
|
示例請求
標頭
1
2
3
4
|
{
"X-Cybozu-API-Token": "API_TOKEN",
"Content-Type": "application/json"
}
|
有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範
內文
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
{
"app": 12343,
"record": 4,
"comment": {
"text": "這是來自系統的回覆。請確認。 ",
"mentions": [
{
"code": "takahashi",
"type": "USER"
},
{
"code": "guest/yamada@test.jp",
"type": "USER"
},
{
"code": "営業本部_OZKQWZ",
"type": "ORGANIZATION"
},
{
"code": "管理部受付_zX6C6r",
"type": "GROUP"
}
]
}
}
|
屬性
屬性名稱 |
類型 |
說明 |
id |
數值 |
您發佈的回覆的評回覆ID。 |
示例回應
使用 curl 的請求
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
curl -X POST 'https://sample.cybozu.com/k/v1/record/comment.json' \
-H 'X-Cybozu-API-Token: API_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"app": 1,
"record": 1001,
"comment": {
"text": "這是來自系統的回覆。請確認。 ",
"mentions": [
{
"code": "takahashi",
"type": "USER"
},
{
"code": "guest/yamada@test.jp",
"type": "USER"
},
{
"code": "営業本部_OZKQWZ",
"type": "ORGANIZATION"
},
{
"code": "管理部受付_zX6C6r",
"type": "GROUP"
}
]
}
}'
|
kintone.api()
請求使用
有關詳細的kintone.api()
,請參閱以下頁面。
發送kintone REST API請求
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
const body = {
app: kintone.app.getId(),
record: 1001,
comment: {
text: '這是來自系統的回覆。 \n請確認。 ',
mentions: [
{
code: 'takahashi',
type: 'USER'
},
{
code: 'guest/yamada@test.jp',
type: 'USER'
},
{
code: '営業本部_OZKQWZ',
type: 'ORGANIZATION'
},
{
code: '管理部受付_zX6C6r',
type: 'GROUP'
}
]
}
};
await kintone.api(kintone.api.url('/k/v1/record/comment.json'), 'POST', body);
|