kintone API

取得記錄

通過指定記錄ID來獲取單個記錄的內容。

目錄

HTTP 方法GET
URLhttps://sample.cybozu.com/k/v1/record.json
URL(訪客空間)https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/record.json
認證 密碼驗證 , API令牌認證 , 會話認證 , OAuth認證
Content-Typeapplication/json(URL中指定參數時不需指定此項)

請求參數

參數名稱 類型 必須 說明
app 數值或字串 必須 應用ID
id 數值或字串 必須 記錄ID

回應屬性

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

所需存取權限

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

範例

1
https://sample.cybozu.com/k/v1/record.json?app=8&id=100
1
2
3
{
  "X-Cybozu-API-Token": "API_TOKEN"
}

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

1
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
}

有關kintone.api()的說明,請參閱以下頁面。
傳送kintone REST 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);

根據您的環境,curl的格式可能會有所不同。
有關說明,請參閱以下頁面。
使用curl命令執行kintone REST API/3.執行API

1
2
curl -X GET 'https://sample.cybozu.com/k/v1/record.json?app=1&id=2' \
  -H 'X-Cybozu-API-Token: API_TOKEN'

補充

  • 如果您想獲取多條記錄,請參考以下 API。
    獲取多條記錄

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

    • API 權杖身分驗證:管理員的顯示語言
    • 其他認證方式:執行API的用戶的顯示語言

    如果語言設置為「與網路瀏覽器設定相同」,則要獲取的語言將根據請求請求標頭中是否包含「Accept-Language」而變更。
    請求標頭

    • 帶標題:帶標頭:「Accept-Language」標頭中指定的語言
    • 無標頭:在cybozu.com通用管理的地區設定中設置的語言
      地區設定 (External link)
  • 「GET」請求最常見的方式是「在URL中指定參數」。
    其他請求方法請參閱以下頁面。
    在REST API中使用GET的三種方法及其使用方法