Obtener complementos de aplicaciones

Documentos de API

Obtener complementos de aplicaciones

Obtiene la lista de complementos agregados a una aplicación.

Método	GET
URL	https://{subdomain}.kintone.com/k/v1/app/plugins.json
URL (espacio de invitado)	https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/app/plugins.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/app/plugins.json
URL (espacio de invitado)	https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/plugins.json

Permisos

Se necesitan permisos de administración de aplicaciones.

Parámetros de solicitud

Parámetro	Valor	Obligatorio	Descripción
app	Entero o cadena	Sí	El identificador de la aplicación.
lang	Cuerda	Opcional	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 es: recupera los nombres españoles 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.

Solicitud de muestra

JavaScript using kintone.api()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


var body = {
  'app': 1,
  'lang': 'en'
};
kintone.api(kintone.api.url('/k/v1/app/plugins.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
16


var params = '?app=1&lang=en';
var url = 'https://{subdomain}.kintone.com/k/v1/app/plugins.json' + params;
console.log(url);
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
plugins	Matriz de objetos	Una lista de plug-ins agregados a la aplicación.
plugins[].id	Cuerda	El ID del complemento.
plugins[].name	Cuerda	El nombre del plugin.
plugins[].enabled	Booleano	El estado del plugin. `true` para plugins activos, y `false` para plugins inactivos.
revision	Cuerda	El número de revisión de la aplicación.

Ejemplo de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


{
    "plugins": [
        {
            "id": "djmhffjhfgmebgnmcggopedaofckljlj",
            "name": "Plugin Name",
            "enabled": true
        }
    ],
    "revision": "2"
}