Documentos de API

Evaluar los permisos de registro

Evalúa los permisos del usuario de la API para los registros y campos dentro de una aplicación.

MétodoGET
URLhttps://{subdomain}.kintone.com/k/v1/records/acl/evaluate.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records/acl/evaluate.json
Autenticación Autenticación de contraseña , Autenticación de sesión
Content-Typeapplication/json (no es necesario si se especifica la consulta con una cadena de consulta)

Contenido

Permisos

Se necesita permiso para ver la aplicación.
Los tokens de API no se pueden usar con esta API.

Parámetros de solicitud

Parámetro Tipo Obligatorio Descripción
app Integer o String Sí El identificador de la aplicación.
ids Matriz de enteros Sí Matriz de identificadores de registro que se evaluarán.
El límite máximo es de 100 identificadores.

Ejemplo de parámetros en la URL

1

https://{subdomain}.kintone.com/k/v1/records/acl/evaluate.json?app=1&ids[0]=1&ids[1]=2

Ejemplo de parámetros en el cuerpo de la solicitud

1
2
3
4

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

Solicitud de muestra

JavaScript using kintone.api() 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

var body = {
  'app': 1,
  'ids': [1, 2]
};

kintone.api(kintone.api.url('/k/v1/records/acl/evaluate.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

var url = 'https://{subdomain}.kintone.com/k/v1/records/acl/evaluate.json?app=1&ids[0]=1&ids[1]=2';
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();

Parámetros de respuesta

Parámetro Tipo Descripción
rights Arreglo Matriz de objetos que contienen la configuración de permisos de los registros especificados.
rights[].id Cuerda El identificador de registro.
rights[].record Objeto Objeto que consta de permisos de registro del identificador de registro especificado.
rights[].record.viewable Booleano Los permisos de visualización del ID de registro especificado. Si la aplicación Kintone está en modo de mantenimiento, el valor devuelto es false.
rights[].record.editable Booleano Los permisos de edición del ID de registro especificado. Si la aplicación Kintone está en modo de mantenimiento, el valor devuelto es false.
rights[].record.deletable Booleano Los permisos de eliminación del ID de registro especificado. Si la aplicación Kintone está en modo de mantenimiento, el valor devuelto es false.
rights[].fields Objeto Un objeto que consta de permisos de campo del ID de registro especificado.
En la respuesta también se incluyen los siguientes elementos:
  • Campos para los que el usuario no tiene permisos para ver
  • Campos que no tienen ninguna configuración de permisos establecida en ellos
  • Campos que no permiten establecer permisos
  • Campos establecidos en tablas
rights[].fields.(fieldcode).viewable Booleano Los permisos de visualización del campo del ID de registro especificado. Si el usuario no tiene permisos de visualización del registro o la aplicación Kintone está en modo de mantenimiento, el valor devuelto es false.
rights[].fields.(fieldcode).editable Booleano Los permisos de edición del campo del ID de registro especificado. Si la aplicación Kintone está en modo de mantenimiento, el valor devuelto es false.

Ejemplo de respuesta

 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
41
42
43
44
45
46
47
48

{
  "rights": [
    {
      "id": "1",
      "record": {
        "viewable": true,
        "editable": false,
        "deletable": false
      },
      "fields": {
        "Text": {
          "viewable": true,
          "editable": false
        },
        "Text_Area": {
          "viewable": false,
          "editable": false
        },
        "Updated_datetime": {
          "viewable": true,
          "editable": false
        },
        "Updated_by": {
          "viewable": true,
          "editable": false
        }
      }
    },
    {
      "id": "2",
      "record": {
        "viewable": true,
        "editable": true,
        "deletable": true
      },
      "fields": {
        "Text": {
          "viewable": true,
          "editable": true
        },
        "Text_Area": {
          "viewable": true,
          "editable": true
        }
      }
    }
  ]
}