Cuando se realiza una solicitud para obtener una lista de recursos de la API, define un límite predeterminado de 50* para la cantidad de recursos que se devuelven.
Para recuperar los resultados que contienen una cantidad de registros superior al límite, la API devuelve un parámetro after que se puede utilizar para enviar otra solicitud para el siguiente conjunto de resultados.
Por ejemplo: Cuando realizas una solicitud para obtener una lista de todos tus pagos, pero la cantidad de pagos supera el límite
{
"payments": [
{
"id": "PM0001",
"created_at": "2017-06-14T04:32:45.482Z",
"charge_date": "2017-06-19",
"amount": 1000,
"description": "prueba",
"currency": "GBP",
"status": "paid_out",
"amount_refunded": 0,
"reference": null,
"metadata": {},
"links": {
"mandate": "MD00012345678",
"creditor": "CR00012345678",
"payout": "PO00012345678",
"subscription": "SB00012345678"
},
-------(SIGUIENTES 49 PAGOS)-------
],
"meta": {
"cursors": {
"before": null,
"after": "PM00050"
},
"limit": 50
}
}
El parámetro after te permite recuperar el siguiente conjunto de resultados haciendo otra llamada a la API. Por ejemplo, https://api.gocardless.com/payments?after=PM00050
Con esto obtendrás otro resultado JSON con un parámetro after. Si after es igual al valor nulo, has llegado al final de los resultados y puedes dejar de hacer solicitudes.
*El valor predeterminado de la cantidad de registros que se devuelven es 50, pero se puede cambiar a 500. Para ello, debes definir el parámetro limit en la solicitud.