kintone Customization Gallery

獲取單條記錄

information

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

目錄

獲取單條記錄

連結已複製

通過指定記錄ID來檢索單個記錄的內容。
如果要檢索多條記錄，請參閱 選取多條記錄。

URL

連結已複製

常規應用程式
https://sample.cybozu.com/k/v1/record.json
訪客空間的應用程式
https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/record.json

HTTP 方法

連結已複製

GET

所需存取權限

連結已複製

  • 查看應用程式中記錄的許可權
  • 查看要選取其值的記錄的許可權
  • 查看要選取其值的欄位的許可權

請求

連結已複製

參數
參數名稱 類型 必須 說明
app 數位或字串 必須 應用ID
id 數位或字串 必須 記錄ID
範例請求（如果在網址中包含參數 ）
URL

https://sample.cybozu.com/k/v1/record.json?app=8&id=100

標頭
1
2
3

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

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

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

https://sample.cybozu.com/k/v1/record.json

標頭
1
2
3
4

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

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

內文
1
2
3
4

{
  "app": 8,
  "id": 100
}

回應

連結已複製

屬性
屬性名稱 類型 說明
record 物件 有關選取到的記錄的資訊
有關欄位格式，請參閱 欄位格式。

示例代碼

連結已複製

使用 curl 的請求
1
2

curl -X GET 'https://sample.cybozu.com/k/v1/record.json?app=1&id=2' \
  -H 'X-Cybozu-API-Token: API_TOKEN'
發送kintone REST API請求 使用API 發送請求
1
2
3
4
5
6

const body = {
  app: kintone.app.getId(),
  id: 2
};

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

補充

連結已複製

  • 記錄中數據的語言由身份驗證方法確定。

    • API 令牌身份驗證：”Administrator”顯示語言
    • 其他認證方式：執行API的用戶的顯示語言

    如果語言設置為“遵循 Web 瀏覽器設置”，則要檢索的語言將根據 請求標頭 中是否包含“Accept-Language”而更改。

    • 帶標頭：”Accept-Language”標頭中指定的語言
    • 無標頭：在通用管理的” 區域設置 (External link) “中設置 cybozu.com 語言