Documentos de API

Obtener plug-ins instalados

Obtiene la lista de plug-ins importados a Kintone.

MétodoGET
URLhttps://{subdomain}.kintone.com/k/v1/plugins.json
Autenticación Autenticación de contraseña , Autenticación de sesión
Content-Typeapplication/json (no es necesario si se especifica la consulta con una cadena de consulta)

Contenido

Permisos

  • No se necesitan permisos.

Parámetros de solicitud

Parámetro Tipo Obligatorio Descripción
offset Integer El número de plug-ins que se van a omitir de la lista de plug-ins instalados.
Si se omite, este valor es 0.
limit Integer El número máximo de plug-ins que se van a recuperar.
Debe estar entre 1 y 100.
El número predeterminado es 100.
ids Matriz de cadenas El ID del complemento. El límite máximo de identificadores que se pueden especificar es 100.
Si null o se especifica una matriz vacía, este parámetro se ignorará y se devolverá una lista de complementos.

Solicitud de muestra

JavaScript using kintone.api()

Sample cuando el ids se omite

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

var body = {
  'offset': 1,
  'limit': 3
};
kintone.api(kintone.api.url('/k/v1/plugins.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

Sample cuando el ids se especifica el parámetro

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

var body = {
  'ids': ['nldmflmpgchoodanjholbdewsdjkhpban', 'jdkslfbeksonbmvkelsodkfyquxnsja']
};
kintone.api(kintone.api.url('/k/v1/plugins.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

Muestra de curl

Sample cuando el ids se omite

1
2
3
4
5
6

curl -X GET 'https://{subdomain}.kintone.com/k/v1/plugins.json' \
  -H 'X-Cybozu-Authorization:{AuthorizationCode}' \
  -H 'Content-Type: application/json' \
  -d '{
    "offset": 1, "limit": 3
  }'

Sample cuando el ids se especifica el parámetro

 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

curl -X GET 'https://{subdomain}.kintone.com/k/v1/plugins.json' \
  -H 'X-Cybozu-Authorization:{AuthorizationCode}' \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": ["nldmflmpgchoodanjholbdewsdjkhpban", "jdkslfbeksonbmvkelsodkfyquxnsja"]
  }'

### Response Parameters {#response-parameters}

| Parameter | Type | Description |
| :-- | :-- | :-- |
| plugins | Array of Objects | A list of plug-ins added to the App.<br>Plug-ins are listed in descending order of the datetime they are added.|
| plugins[].id | String | The plug-in ID. |
| plugins[].name | String | The name of the plug-in. |
| plugins[].isMarketPlugin | Boolean | States whether or not the plug-in is a Marketplace plug-in.<ul><li>`true`: The plug-in is a Marketplace plug-in.</li><li>`false`: The plug-in is not a Marketplace plug-in.</li></ul> |
| plugins[].version | String | The version number of the plug-in. |
| plugins[].description | String | The Plug-in description. If there is no description, an empty string will be returned. |

### Sample Response {#sample-response}

```json
{
    "plugins": [
        {
          "id": "djmhffjhfgmebgnmcggopedaofckljlj",
          "name": "Plugin 1",
          "isMarketPlugin": false,
          "version": "1",
          "description": "Description of Plugin 1"
        },
        {
          "id":"ejgcopfamifdhmkafjgidfmgjdmiaplf",
          "name":"Plugin 2",
          "isMarketPlugin":false,
          "version":"2",
          "description": "Description of Plugin 2"
        },
        {
          "id":"fdeplpmkengkldpdlaiegpokgmaabkkb",
          "name":"Plugin 3",
          "isMarketPlugin":false,
          "version":"4.5.1",
          "description": "Description of Plugin 3"
          }
    ]
}