獲取已新增到應用的外掛程式清單

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

獲取已新增到應用的外掛程式清單

獲取要添加外掛程式的應用資訊清單。
您還可以在外掛程式附加項反映之前獲取應用程式資訊。

URL

https://sample.cybozu.com/k/v1/plugin/apps.json

HTTP 方法

GET

所需存取權限

  • cybozu.com共通管理員

請求

參數
參數名稱 類型 必須 說明
id 字串 必須 外掛程式ID
offset 數值或字串 可省略 要從獲取到的清單中跳過的號碼。
如果省略,則設置為0。
limit 數值或字串 可省略 要獲取的應用的最大數量。
您可以指定一個介於 100 和 500 之間的數值。
如果省略,則設置為100。
範例請求(如果要在網址中包含參數 )
URL

https://sample.cybozu.com/k/v1/plugin/apps.json?id=djmhffjhfgmebgnmcggopedaofckljlj&offset=1&limit=1

標頭
1
2
3
{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範

範例請求(如果要在請求正文中包含參數)
URL

https://sample.cybozu.com/k/v1/plugin/apps.json:

標頭
1
2
3
4
{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範

正文
1
2
3
4
5
{
  "id": "djmhffjhfgmebgnmcggopedaofckljlj",
  "offset": 1,
  "limit": 1
}

回應

屬性
屬性名稱 類型 說明
apps 陣列(物件) 已添加外掛程式的應用資訊陣列
排序順序按應用程式ID升序。
如果要添加的應用不存在,則返回一個空陣列。
apps[].id 字串 應用ID
apps[].name 字串 應用程序名稱
示例回應
1
2
3
4
5
6
7
8
{
  "apps": [
    {
      "id": "1",
      "name": "樣本應用程式"
    }
  ]
}

示例代碼

使用 curl 的請求
1
2
3
4
5
6
7
curl -X GET 'https://sample.cybozu.com/k/v1/plugin/apps.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "djmhffjhfgmebgnmcggopedaofckljlj",
    "limit": 1
  }'
kintone.api()請求使用

有關詳細的kintone.api(),請參閱以下頁面。
發送kintone REST API請求

1
2
3
4
5
6
const body = {
  id: 'djmhffjhfgmebgnmcggopedaofckljlj',
  limit: 1,
};

await kintone.api(kintone.api.url('/k/v1/plugin/apps.json', true), 'GET', body);