kintone Customization Gallery

獲取執行 API 的用戶記錄的訪問設置

information

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

目錄

獲取對執行 API 的使用者的記錄的訪問許可權

連結已複製

檢索運行 API 的使用者的記錄或欄位的存取設置。

URL

連結已複製

常規應用
https://sample.cybozu.com/k/v1/records/acl/evaluate.json
建立訪客空間
https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/records/acl/evaluate.json

HTTP 方法

連結已複製

GET

所需許可權

連結已複製

您必須具有以下權限之一：

  • 查看應用程式中記錄的許可權
  • 在應用程式中添加記錄的許可權

請求

連結已複製

參數
參數名稱 型 必須 說明
app 數位或字串 必須 應用ID
ids 陣列（數位） 必須 要訪問的記錄的記錄ID
您最多可以指定 100 個記錄 ID。
如果它包含不存在的記錄 ID，則會導致錯誤。
範例請求（如果要在網址中包含參數 ）
URL

https://sample.cybozu.com/k/v1/records/acl/evaluate.json?app=8&ids[0]=1&ids[1]=2

頁眉
1
2
3

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

關於請求頭，請參見 kintone REST API的通用規範 。

範例要求（如果要在要求正文中包含參數）
URL

https://sample.cybozu.com/k/v1/records/acl/evaluate.json

頁眉
1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

關於請求頭，請參見 kintone REST API的通用規範 。

身體
1
2
3
4

{
  "app": "1",
  "ids": [1, 2]
}

回應

連結已複製

財產
屬性名稱 型 說明
rights 陣列 存取權限清單
rights[].id 字串 記錄ID
rights[].record 物件 設置指定記錄的許可權
rights[].record.viewable 布爾值 是否可以查看記錄
  • true： 可以查看
  • false：不可見
rights[].record.editable 布爾值 是否可以編輯記錄
  • true：可編輯
  • false：無法編輯
rights[].record.deletable 布爾值 是否可以刪除記錄
  • true：可以刪除
  • false：無法刪除
rights[].fields 物件 記錄中存在的欄位的許可權
返回對可由更新記錄的 API 操作的欄位的訪問許可權。
這包括運行 API 的使用者無權查看或您無權訪問的欄位。
表中的欄位與通常放置的欄位的級別相同。
rights[].fields.欄位代碼.viewable 布爾值 是否可以查看該欄位
  • true： 可以查看
  • false：不可見
rights[].fields.欄位代碼.editable 布爾值 是否可以編輯欄位
  • true：可編輯
  • false：無法編輯
示例回應
 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
29
30
31
32
33
34
35
36
37
38
39
40

{
  "rights": [
    {
      "id": "1",
      "record": {
        "viewable": true,
        "editable": false,
        "deletable": false
      },
      "fields": {
        "單行文字方塊_0": {
          "viewable": true,
          "editable": false
        },
        "多行文字方塊_0": {
          "viewable": false,
          "editable": false
        }
      }
    },
    {
      "id": "2",
      "record": {
        "viewable": true,
        "editable": true,
        "deletable": true
      },
      "fields": {
        "單行文字方塊_0": {
          "viewable": true,
          "editable": true
        },
        "多行文字方塊_0": {
          "viewable": true,
          "editable": true
        }
      }
    }
  ]
}

示例代碼

連結已複製

使用 curl 的請求
1
2
3
4
5
6
7

curl -X GET 'https://sample.cybozu.com/k/v1/records/acl/evaluate.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "app": kintone.app.getId(),
    "ids":[1, 2]
  }'
發送kintone REST API請求 使用API 發送請求
1
2
3
4
5
6

const body = {
  app: kintone.app.getId(),
  ids: [1, 2]
};

await kintone.api(kintone.api.url('/k/v1/records/acl/evaluate.json', true), 'GET', body);

限制

連結已複製

  • 不能使用 API 令牌。
  • 此 API 無法存取以下欄位：
    • 記錄號碼 *1
    • 標籤
    • 分隔線
    • 空間
    • 表格
    • 群組
    • 相關記錄清單
    • 建立人
    • 建立時間
    • 更新人
    • 更新時間
  • 欄位的查看和編輯許可權將被記錄的許可權覆蓋。

*1 這是無法在「欄位訪問許可權」 中設置的欄位。 ^