獲取應用的常規設置。

獲取生產環境的設置時，URL 與獲取測試環境的設置時不同。

如果要獲取生產環境的設置

常規應用

https://sample.cybozu.com/k/v1/app/settings.json

建立訪客空間

https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/app/settings.json

獲取操作測試環境的設置

常規應用

https://sample.cybozu.com/k/v1/preview/app/settings.json

建立訪客空間

https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/preview/app/settings.json

GET

如果要獲取生產環境的設置

您必須具有以下權限之一：

• 查看應用程式中記錄的許可權
• 在應用程式中添加記錄的許可權

獲取操作測試環境的設置

• 應用程式管理

參數

參數名稱	型	必須	說明
app	數位或字串	必須	應用ID
lang	字串	自選	要檢索的名稱的語言 如果已在應用名稱和說明 中設置了每種語言的名稱 ，請指定此項。 ja：日本語 en：英語 zh：中文 user：執行 API 的使用者設置為顯示語言的語言 如果語言設置為"遵循 Web 瀏覽器設置"，則要檢索的語言取決於是否存在"Accept-Language"標頭。 帶標頭：「Accept-Language」標頭中指定的語言 無標頭：在通用管理的「 區域設置 」中設置 cybozu.com 語言 default：預設 如果省略，則獲取預設名稱。

範例請求（如果要在網址中包含參數 ）

URL

https://sample.cybozu.com/k/v1/app/settings.json?app=8&lang=ja

頁眉

1
2
3

{
  "X-Cybozu-API-Token": "API_TOKEN"
}

關於請求頭，請參見 kintone REST API的通用規範 。

範例要求（如果要在要求正文中包含參數）

URL

https://sample.cybozu.com/k/v1/app/settings.json

頁眉

1
2
3
4

{
  "X-Cybozu-API-Token": "API_TOKEN",
  "Content-Type": "application/json"
}

身體

1
2
3
4

{
  "app": 4,
  "lang": "ja"
}

財產

示例回應

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "name": "案件管理",
  "description": "営業部の案件管理に使用します。",
  "icon": {
    "type": "PRESET",
    "key": "APP60"
  },
  "theme": "WHITE",
  "revision": "24"
}

使用 curl 的請求

1
2

curl -X GET 'https://sample.cybozu.com/k/v1/app/settings.json?app=8&lang=ja' \
  -H 'X-Cybozu-API-Token: API_TOKEN'

發送kintone REST API請求 使用API 發送請求

1
2
3
4
5
6

const body = {
  app: kintone.app.getId(),
  lang: 'ja'
};

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