Obtener cursor
Recupera varios registros de una aplicación especificando el identificador del cursor.
Método | GET |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/records/cursor.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records/cursor.json |
Autenticación | Autenticación de contraseña , Autenticación de token de API , Autenticación de sesión |
Content-Type | application/json |
Contenido
Permisos
El usuario o el token de API deben tener permiso para ver los registros.
Parámetros de solicitud
Parámetro | Valor | Obligatorio | Descripción |
---|---|---|---|
id | Cuerda | Sí | El ID del cursor. |
Solicitud de muestra
|
|
Muestra de curl
|
|
Parámetros de respuesta
Parámetro | Tipo | Descripción |
---|---|---|
records | Arreglo | Matriz de objetos que incluye datos de campo de registros que coinciden con la consulta. La respuesta es la misma que la respuesta de la API Get Records. Para obtener más información, consulte el siguiente documento: Obtener registros |
next | Booleano | Indica si hay más registros que se pueden adquirir desde el cursor.
El cursor seguirá siendo válido hasta que se hayan obtenido todos los registros. |
Ejemplo de respuesta
|
|
Limitaciones
-
La API Get Cursor devuelve archivo que coincidan con la consulta en el momento en que se llama a la API Add Cursor. Para obtener más información, consulte el siguiente documento:
Agregar cursor
Sin embargo, la API Get Cursor devuelve el atributo Valores de campo de registros en el momento en que se llama a la API Get Cursor. -
En el caso de que se aplique una nueva configuración de permisos a la aplicación después de agregar un cursor, la API Get Cursor puede devolver registros que no deben coincidir con la consulta con los nuevos permisos. En este caso, los valores de los campos sin permisos de visualización no se pueden ver en la respuesta.
-
Dado que los valores de campo obtenidos dependen de cuándo se llama a la API Get Cursor, los valores obtenidos de los campos localizados pueden variar en función de la configuración de idioma del iniciador de la API.
-
Puede haber casos en los que el siguiente conjunto de registros obtenidos (cuando el next El parámetro es
true
) está vacío, si los registros se eliminan o tienen una nueva configuración de permisos aplicada durante las solicitudes de la API Get Cursor. -
El cursor se eliminará automáticamente cuando responda
false
En el caso de la next parámetro. Cualquier solicitud adicional dará como resultado una respuesta de error 404. -
Si la cadena de consulta incluye like y not like operadores, la búsqueda se detendrá después de que coincida con 100.000 registros. En este caso, "x-cybozu-warning : Filtro abortado debido a demasiados resultados de búsqueda." se incluirá en el encabezado de respuesta.
Notas
- El idioma de los datos de registro devueltos depende del método de autenticación utilizado:
- Cuando el
Accept-Language
request header, se devolverá el idioma especificado, si se ha establecido en la configuración regional. Para obtener más información sobre los encabezados de solicitud, consulte el siguiente documento:
Encabezados de solicitud - Autenticación de token de API: Se utilizará el idioma de visualización de la cuenta de administrador.
- Otras formas de autenticación: Se utilizará el idioma de visualización de la cuenta de usuario.
- Cuando el idioma de visualización se establece en Usar la configuración del navegador web, el idioma especificado en el Administración de Usuarios y Sistemas Se usará la configuración regional.
- La configuración regional del sistema se puede cambiar a través de la función Administración de Usuarios y Sistemas Configuración regional. Para obtener más información, consulte el siguiente artículo:
Configuración del idioma del sistema
- Cuando el