kintone API文件

填寫記錄回覆

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.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);