獲取單條記錄

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 語言