/v1 devuelve el mismo sobre, esté paginada o no:
Qué listas están paginadas
Las listas no paginadas devuelven todos los elementos en una sola página con
"hasMore": false e ignoran limit y cursor. De todos modos, usa el mismo ciclo para todas las listas: si alguna pasa a estar paginada, tu código seguirá funcionando sin cambios.
Parámetros de consulta
integer
predeterminado:"50"
Cuántos elementos devolver, de 1 a 200. Solo se aceptan dígitos. Un 0, un número negativo, un decimal, un texto o un número mayor que 200 se rechaza con
400 y el código common.invalid_request.string
El
nextCursor de la página anterior, copiado tal cual. Un cursor que no se puede leer se rechaza con 400 y el código common.invalid_request; el servidor nunca vuelve en silencio a la primera página.string
Solo en
GET /v1/orders y GET /v1/fulfillments. Debe ser uno de los valores de estado indicados para esa operación en el grupo Endpoints (por ejemplo pending_approval para pedidos o dispatched para registros de entrega). Cualquier otro valor se rechaza con 400 y el código common.invalid_request.string
Solo en
GET /v1/inventory/balances: conserva las cajas de un insumo del catálogo. Un id que no coincide con nada devuelve una página vacía.string
Solo en
GET /v1/inventory/balances: conserva las cajas de una bodega. Un id que no coincide con nada devuelve una página vacía.Recorre todas las páginas
Última página
Reglas del cursor
- El cursor es opaco. Trátalo como un token. No lo decodifiques, no lo construyas ni lo modifiques; su formato puede cambiar sin aviso.
- Un cursor marca una posición, no un número de página. La página siguiente empieza justo después del último elemento que recibiste. Los elementos creados mientras recorres la lista no se saltan ni se repiten: los pedidos y registros de entrega nuevos aparecen al final, porque esas listas van del más antiguo al más reciente.
- Envía los mismos filtros en cada página. El cursor guarda solo la posición. Si cambias
status,catalogItemIdowarehouseIda mitad de camino, la página siguiente aplica los filtros nuevos desde esa posición. - Los filtros se aplican en cada solicitud. Si un pedido cambia de estado mientras recorres
GET /v1/orders?status=approved, puede salir del filtro antes de que llegues a él. - Usa un cursor solo con la operación que lo emitió. Un cursor de una lista no sirve en otra.
- Usa
limit=200para recorridos completos. Menos páginas, más grandes, consumen menos de tu presupuesto de solicitudes (consulta Límites de uso).
Errores
Páginas relacionadas
- Guía rápida de la API
- Webhooks: cómo consultar listas periódicamente para mantenerte al día
- Errores