Obtener permisos de registro

Documentos de API

Obtener permisos de registro

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

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

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/record/acl.json
URL (espacio de invitado)	https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/record/acl.json

Permisos

Se necesita permiso para administrar la aplicación al obtener datos de aplicaciones en vivo.
Se necesita permiso para administrar la aplicación cuando se obtienen datos de la configuración previa a la transmisión.

Parámetros de solicitud

Parámetro	Valor	Obligatorio	Descripción
app	Entero o cuerda	Sí	El identificador de la aplicación.
lang	Cuerda		El idioma localizado en el que se recuperarán los datos: `default`: recupera los nombres predeterminados `en`: recupera los nombres localizados en inglés `zh`: recupera los nombres chinos localizados `ja`: recupera los nombres japoneses localizados `user`: recupera los nombres localizados en el mismo idioma que la configuración de idioma** establecida en el usuario utilizado para la autenticación. Si se ignora, se recuperarán los nombres predeterminados.

**Si la configuración de idioma del usuario se establece en Usar la configuración del navegador web, se utilizará la configuración establecida en el encabezado Accept-Language. Si no hay ningún encabezado Accept-Language, el idioma establecido en el Localización en el menú del administrador del sistema.

Solicitud de muestra

JavaScript using kintone.api()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


var body = {
  'app': 1
};

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

Parámetros de respuesta

Parámetro	Tipo	Descripción
rights	Arreglo	Matriz de objetos que contienen datos de permisos de registro, en orden de prioridad.
rights[].filterCond	Cuerda	La condición de filtro del permiso de registro. Para obtener más datos sobre los formatos de consulta, consulte el siguiente documento: Cadena de consulta
rights[].entities	Arreglo	Matriz que enumera las entidades a las que se conceden los permisos, en orden de prioridad.
rights[].entities[].entity	Objecto	Objeto que contiene datos 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[].entity.code	Cuerda	El código de la entidad a la que se concede el permiso.
rights[].entities[].viewable	Booleano	El permiso de vista de la entidad. `true`: El registro es visible. `false`: El registro no se puede ver.
rights[].entities[].editable	Booleano	El permiso de edición de la entidad. `true`: El registro es editable. `false`: El registro no es editable.
rights[].entities[].deletable	Booleano	El permiso de eliminación de la entidad. `true`: El registro es eliminable. `false`: El registro no se puede eliminar.
rights[].entities[].includeSubs	Booleano	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.
revision	Cuerda	El número de revisión de la configuración de la aplicación.

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


{
  "rights": [
    {
      "filterCond": "Updated_datetime > \"2017-02-03T09:00:00Z\" and Updated_datetime < \"2017-02-03T10:00:00Z\"",
      "entities": [
        {
          "entity": {
            "type": "ORGANIZATION",
            "code": "org1"
          },
          "viewable": false,
          "editable": false,
          "deletable": false,
          "includeSubs": true
        },
        {
          "entity": {
            "type": "FIELD_ENTITY",
            "code": "Updated_by"
          },
          "viewable": true,
          "editable": true,
          "deletable": true,
          "includeSubs": false
        }
      ]
    }
  ],
  "revision": "2"
}