從游標中選取記錄
從游標中選取記錄。
URL
- 常規應用程式
- https://sample.cybozu.com/k/v1/records/cursor.json
- 訪客空間的應用程式
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/records/cursor.json
HTTP 方法
GET
所需存取權限
- 查看應用程式中記錄的許可權
- 查看要選取其值的記錄的許可權
- 查看要選取其值的欄位的許可權
請求
參數
參數名稱 | 類型 | 必須 | 說明 |
---|---|---|---|
id | 字串 | 必須 | 游標ID |
範例請求(如果要在網址中包含參數 )
URL
https://sample.cybozu.com/k/v1/records/cursor.json?id=9a9716fe-1394-4677-a1c7-2199a5d28215
標頭
|
|
有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範
要求範例(如果要在要求內文中包含參數)
URL
https://sample.cybozu.com/k/v1/records/cursor.json
標頭
|
|
有關請求頭的詳細資訊,請參閱通用規格。
kintone REST API通用規範
內文
|
|
回應
屬性
屬性名稱 | 類型 | 說明 |
---|---|---|
records | 陣列 | 記錄清單 有關欄位格式,請參閱以下頁面。 欄位格式 |
next | 布爾值 | 是否有以下記錄:
|
示例回應
|
|
示例代碼
使用 curl 的請求
|
|
kintone.api()
請求使用
有關詳細的kintone.api()
,請參閱以下頁面。
發送kintone REST API請求
|
|
補充
-
記錄中數據的語言由身份驗證方法確定。
- API 權杖身分驗證:管理員顯示語言
- 其他認證方式:執行API的用戶的顯示語言
如果語言設置為「與網路瀏覽器設定相同」,則要獲取的語言將根據請求請求標頭中是否包含「Accept-Language」而變更。
請求標頭- 帶標題:帶標頭:「Accept-Language」標頭中指定的語言
- 無標頭:在通用管理的地區設定中設置 cybozu.com 語言
地區設定
限制事項
- 可以從遊標中獲取的記錄是在創建遊標時獲取到的記錄。
但是,在執行此 API 時將返回該欄位的值。 - 如果在創建遊標后變更了許可權設置,則變更的設置可能會獲取到不應滿足過濾條件的記錄。
但是,您無法獲取您無權查看的欄位的值。 - 如果在創建遊標后變更運行 API 的用戶的語言設置,則多語言欄位將受到影響。
- 獲取到可從游標中獲取的所有記錄后,將自動刪除該遊標。
- 在回應中
next
但true
即使你得到了records
可能會空返回。