獲取執行 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
    • 分隔線 *1
    • 空間 *1
    • 表格 *1
    • 群組
    • 相關記錄清單
    • 建立人
    • 建立時間
    • 更新人
    • 更新時間
  • 欄位的查看和編輯許可權將被記錄的許可權覆蓋。

*1 這是無法在"欄位的存取權限" 中設置的欄位。 ^