貼文記錄回覆

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

貼文記錄回覆

將回覆貼文到記錄中。

  • 如果您使用 API 令牌,則貼文使用者將是”Administrator”。
  • 目標的名稱基於運行 API 的使用者的語言設置。
  • 暫停的使用者、已刪除的用戶、組織和組不會收到通知。
  • 對於訪客空間,離開組的使用者將具有與已刪除使用者相同的行為。
  • 如果將受邀的來賓使用者指定為目標,則會發生錯誤。
  • 如果您在禁用記錄回覆的應用程式中運行它,則會出現錯誤。

URL

常規應用程式
https://sample.cybozu.com/k/v1/record/comment.json
訪客空間的應用程式
https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/record/comment.json

HTTP 方法

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。
示例回應
1
2
3
{
  "id": 3
}

示例代碼

使用 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 REST API請求的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);