Documentos de API

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 Tipo Obligatorio Descripción
app Integer o String Sí El identificador de la aplicación.
lang String 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 Array Matriz de objetos que contienen datos de permisos de registro, en orden de prioridad.
rights[].filterCond String 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 Array Matriz que enumera las entidades a las que se conceden los permisos, en orden de prioridad.
rights[].entities[].entity Object Objeto que contiene datos de la entidad a la que se concede el permiso.
rights[].entities[].entity.type String 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 String El código de la entidad a la que se concede el permiso.
rights[].entities[].viewable Boolean El permiso de vista de la entidad.
  • true: El registro es visible.
  • false: El registro no se puede ver.
rights[].entities[].editable Boolean El permiso de edición de la entidad.
  • true: El registro es editable.
  • false: El registro no es editable.
rights[].entities[].deletable Boolean El permiso de eliminación de la entidad.
  • true: El registro es eliminable.
  • false: El registro no se puede eliminar.
rights[].entities[].includeSubs Boolean 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 String 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"
}