Documentos de API

Obtener permisos de la aplicación

Obtiene los permisos de aplicación de una aplicación.

MétodoGET
URLhttps://{subdomain}.kintone.com/k/v1/app/acl.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/app/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 han 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/app/acl.json
URL (espacio de invitado) https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/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 puesta en marcha.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
app Entero o cadena Sí El ID de la aplicación

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/app/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
15

var url = 'https://{subdomain}.kintone.com/k/v1/app/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 aplicación, en orden de prioridad.
rights[].entity Objeto Objeto que contiene datos de la entidad a la que se concede el permiso.
rights[].entity.type Cuerda El tipo de entidad a la que se concede el permiso.
  • USER: Usuario
  • GROUP: Grupo
  • ORGANIZATION: Departamento
  • CREATOR: El creador de la App
rights[].entity.code Cuerda El código de la entidad a la que se concede el permiso.
rights[].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.
rights[].appEditable Booleano El permiso de administración de aplicaciones de la entidad.
Las entidades con este permiso pueden acceder y editar la configuración de la aplicación.
  • true: Se puede acceder a la configuración de la aplicación.
  • false: No se puede acceder a la configuración de la aplicación.
rights[].recordViewable Booleano El permiso de vista de registro de la entidad.
  • true: Los registros son visibles.
  • false: Los registros no se pueden ver.
rights[].recordAddable Booleano El permiso de adición de registro de la entidad
  • true: Se pueden agregar registros.
  • false: No se pueden agregar registros.
rights[].recordEditable Booleano El permiso de edición de registros de la entidad.
  • true: Los registros son editables.
  • false: Los registros no son editables.
rights[].recordDeletable Booleano El permiso de eliminación de registros de la entidad.
  • true: Los registros son eliminables.
  • false: Los registros no se pueden eliminar.
rights[].recordImportable Booleano El permiso de importación de archivos de la entidad.
  • true: Los archivos son importables
  • false: Los archivos no se pueden importar
rights[].recordExportable Booleano El permiso de exportación de archivos de la entidad.
  • true: Los archivos son exportables
  • false: Los archivos no se pueden exportar
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

{
  "rights": [
    {
      "entity": {
        "type": "USER",
        "code": "user1"
      },
      "includeSubs": false,
      "appEditable": true,
      "recordViewable": true,
      "recordAddable": true,
      "recordEditable": true,
      "recordDeletable": true,
      "recordImportable": true,
      "recordExportable": true
    },
    {
      "entity": {
        "type": "GROUP",
        "code": "group1"
      },
      "includeSubs": false,
      "appEditable": false,
      "recordViewable": false,
      "recordAddable": false,
      "recordEditable": false,
      "recordDeletable": false,
      "recordImportable": false,
      "recordExportable": false
    },
    {
      "entity": {
        "type": "ORGANIZATION",
        "code": "org1"
      },
      "includeSubs": true,
      "appEditable": false,
      "recordViewable": true,
      "recordAddable": true,
      "recordEditable": true,
      "recordDeletable": true,
      "recordImportable": true,
      "recordExportable": true
    },
    {
      "entity": {
        "type": "CREATOR",
        "code": null
      },
      "includeSubs": false,
      "appEditable": true,
      "recordViewable": true,
      "recordAddable": true,
      "recordEditable": true,
      "recordDeletable": true,
      "recordImportable": true,
      "recordExportable": true
    }
  ],
  "revision": "2"
}