Immer, wenn Sie eine Anfrage nach einer Liste von Ressourcen von der API stellen, wird die Obergrenze für die Zahl der ausgegebenen Ressourcen standardmäßig auf 50* festgelegt.
Um Ergebnisse mit mehr Datensätzen abzurufen, gibt die API einen after-Parameter aus, mit dem eine zusätzliche Anfrage nach den weiteren Ergebnissen gestellt werden kann.
Z. B. Sie führen eine Abfrage der Liste aller Ihrer Zahlungen durch, aber die Anzahl der Zahlungen überschreitet die Obergrenze
{
"payments": [
{
"id": "PM0001",
"created_at": "2017-06-14T04:32:45.482Z",
"charge_date": "2017-06-19",
"amount": 1000,
"description": "test",
"currency": "GBP",
"status": "paid_out",
"amount_refunded": 0,
"reference": null,
"metadata": {},
"links": {
"mandate": "MD00012345678",
"creditor": "CR00012345678",
"payout": "PO00012345678",
"subscription": "SB00012345678"
},
-------(WEITERE 49 ZAHLUNGEN)-------
],
"meta": {
"cursors": {
"before": null,
"after": "PM00050"
},
"limit": 50
}
}
Mit dem after-Parameter können Sie dann die nächsten Ergebnisse abrufen, indem Sie eine weitere Anfrage an die API stellen, z. B. https://api.gocardless.com/payments?after=PM00050.
Damit erhalten Sie ein weiteres JSON-Ergebnis mit einem after-Parameter. Wenn after einem Nullwert entspricht, haben Sie das Ende der Ergebnisse erreicht und müssen keine weiteren Anfragen mehr stellen.
*Der Standardwert für die Anzahl der ausgegebenen Datensätze ist 50, kann jedoch auf 500 erhöht werden, indem Sie im Rahmen Ihrer Abfrage den limit-Parameter ändern.