Obtener permisos de campo

Obtiene la configuración de permisos de campo de una aplicación.

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

Contenido

Ajustes previos a la transmisión en vivo

Es posible que las aplicaciones contengan configuraciones previas a la transmisión en vivo que aún no se hayan implementado en la aplicación en vivo.
Acceda a la configuración previa a la transmisión en vivo con la siguiente URL.

URL https://{subdomain}.kintone.com/k/v1/preview/field/acl.json
URL (espacio de invitado) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/field/acl.json

Permisos

  • Los permisos de administración de aplicaciones son necesarios para obtener información de aplicaciones activas.
  • Los permisos de administración de aplicaciones son necesarios para obtener información de la configuración previa a la transmisión.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
app Entero o cadena El identificador de la aplicación.

Solicitud de muestra

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
var body = {
  'app': 1
};

kintone.api(kintone.api.url('/k/v1/field/acl.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/field/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();

Parámetros de respuesta

Parámetro Tipo Descripción
revision Cuerda El número de revisión de la configuración de la aplicación.
rights Arreglo Matriz de objetos que contienen datos de la configuración de permisos.
rights[].code Cuerda El código de campo de un campo que tiene una configuración de permisos.
rights[].entities Arreglo Matriz que enumera las entidades a las que se conceden los permisos, en orden de prioridad.
rights[].entities[].accessibility Cuerda El permiso concedido a la entidad.
  • READ: Permisos para ver solamente.
  • WRITE: Permisos para ver y editar.
  • NONE: No hay permisos para ver o editar.
rights[].entities[].entity Objeto Objeto que contiene datos de la entidad a la que se concede el permiso.
rights[].entities[].entity.code Cuerda El código de la entidad a la que se concede el permiso.
rights[].entities[].entity.type Cuerda El tipo de entidad a la que se concede el permiso.
  • USER: Usuario
  • GROUP: Grupo
  • ORGANIZATION: Departamento
  • FIELD_ENTITY: Campo de usuario
rights[].entities[].includeSubs Booleano o cadena La configuración de herencia de permisos del departamento al que se concede el permiso.
  • true: Los permisos se heredan.
  • false: Los permisos no se heredan.

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
{
  "rights": [
    {
      "code": "Text__single_line_",
      "entities": [
        {
          "accessibility": "WRITE",
          "entity": {
            "type": "USER",
            "code": "user1"
          },
          "includeSubs": false
        },
        {
          "accessibility": "READ",
          "entity": {
            "type": "GROUP",
            "code": "group1"
          },
          "includeSubs": false
        }
      ]
    },
    {
      "code": "Number",
      "entities": [
        {
          "accessibility": "NONE",
          "entity": {
            "type": "ORGANIZATION",
            "code": "org1"
          },
          "includeSubs": true
        }
      ]
    }
  ],
  "revision": "2"
}