Obtener permisos de registro

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

MétodoGET
URLhttps://{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-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/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 cadena 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* 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 un encabezado Accept-Language, se utilizará el idioma establecido en la configuración de "Localización" en el menú del administrador del sistema.

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/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 Objeto 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"
}