中文
获取记录的访问权限的设置。
URI
获取正式环境的设置时所使用的URI跟获取测试环境设置时不一样。
获取正式环境的设置时
https://(子域名).cybozu.cn/k/v1/record/acl.json
来宾空间内的应用：https://(子域名).cybozu.cn/k/guest/(空间的ID)/v1/record/acl.json
获取测试环境的设置时
https://(子域名).cybozu.cn/k/v1/preview/record/acl.json
来宾空间内的应用：https://(子域名).cybozu.cn/k/guest/(空间的ID)/v1/preview/record/acl.json
HTTP 方法
GET
必要的访问权限
应用的管理权限
请求参数
| 参数名称 | 要指定的值 | 必须 | 说明 |
|---|---|---|---|
| app | 数值或字符串 | 必须 | 指定应用的ID。 |
| lang | 字符串 | 语言指定以下任意一个。
|
请求的范例
要发送的请求根据参数发送方式的不同而不同。以下是指定参数“app”和“lang”的请求的例子。
URL中包含参数时
GET /k/v1/record/acl.json?app=8&lang=zh HTTP/1.1 Host: example.cybozu.cn:443 X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
请求正文中包含参数时
头部
GET /k/v1/record/acl.json HTTP/1.1 Host: example.cybozu.cn:443 X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU= Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU= Content-Type: application/json
正文
{
"app": "8",
"lang": "zh"
}应答参数
应答的范例
{
"rights": [
{
"filterCond": "更新时间> \"2012-02-03T09:00:00Z\" and 更新时间 < \"2012-02-03T10:00:00Z\"",
"entities": [
{
"entity": {
"type": "ORGANIZATION",
"code": "org1"
},
"viewable": false,
"editable": false,
"deletable": false,
"includeSubs": true
},
{
"entity": {
"type": "FIELD_ENTITY",
"code": "更新人"
},
"viewable": true,
"editable": true,
"deletable": true,
"includeSubs": false
}
]
}
],
"revision": "2"
}JavaScript 范例
使用API请求发送 kintone REST API 请求
var body = {
"app": 1
};
kintone.api(kintone.api.url('/k/v1/record/acl', true), 'GET', body, function(resp) {
// success
console.log(resp);
}, function(error) {
// error
console.log(error);
});使用 XMLHttpRequest 请求
var url = 'https://{subdomain}.cybozu.cn/k/v1/record/acl.json?app=1';
var xhr = new XMLHttpRequest();
xhr.open('GET', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
if (xhr.status === 200) {
// success
console.log(JSON.parse(xhr.responseText));
} else {
// error
console.log(JSON.parse(xhr.responseText));
}
};
xhr.send();