Obtener complementos de aplicaciones

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

MétodoGET
URLhttps://{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-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/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 El identificador de la aplicación.
lang Cuerda Opcional El idioma localizado en el que se recuperarán los datos:
  • enen: recupera los nombres localizados en inglés
  • zhzh: recupera los nombres chinos localizados
  • jaja: recupera los nombres japoneses localizados
  • eses: recupera los nombres españoles localizados
Si se ignora, se recuperarán los nombres predeterminados.

Solicitud de muestra

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