Entwickler

Paginierung der Public API

Eine Liste der Costfluent Public API seitenweise mit page und limit lesen und ihren Links zur nächsten Seite folgen.

Jede Listenoperation antwortet mit derselben Hülle: die Einträge der Seite in data und Links zu den benachbarten Seiten in links. Kostendaten ergänzen in meta, was die ganze Abfrage umfasst.

Eine Liste seitenweise lesen

Fordere die erste Seite mit page=1 und dem gewünschten limit an.
Verarbeite data.
Ist links.next gesetzt, fordere diesen Link an; er behält jeden Filter der ersten Anfrage. Ist er null, war das die letzte Seite.

Code
curl --get https://api.costfluent.com/v1/budgets \
  --data page=1 --data limit=100 \
  --header "Authorization: Bearer $COSTFLUENT_API_TOKEN"


Code
{
  "links": {
    "self": "https://api.costfluent.com/v1/budgets?page=1&limit=100",
    "first": "https://api.costfluent.com/v1/budgets?page=1&limit=100",
    "prev": null,
    "next": "https://api.costfluent.com/v1/budgets?page=2&limit=100",
    "last": "https://api.costfluent.com/v1/budgets?page=3&limit=100"
  },
  "data": []
}

Seitengröße

Operation	`limit`	Standard
Jede Liste, etwa Budgets, Kostenberichte oder Integrationen	1 bis 100; ein größerer oder kleinerer Wert wird auf diesen Bereich begrenzt	20
Kostendaten, `GET /v1/costs`	1 bis 5.000; ein größerer Wert wird mit `400` abgelehnt	20

Kostendaten in großen Mengen lesen

Kostendaten sind die eine Massenabfrage: Fordere limit=5000 an, um einen Zeitraum mit so wenigen Anfragen wie möglich zu lesen. Die Paginierung reicht bis 100.000 Zeilen, page × limit; eine Anfrage darüber hinaus wird mit 400 abgelehnt, und ihr Fehler sagt, den Zeitraum aufzuteilen. Lies einen großen Zeitraum als mehrere kürzere Bereiche von startDate bis endDate, jeden ab Seite 1.

meta.totalRecords zählt jede Zeile, auf die die Abfrage passt; meta.totalRecords geteilt durch limit sagt dir also vorab, wie viele Seiten du erwarten kannst.

Wie es sich verhält

page beginnt bei 1. Eine Seite hinter dem Ende antwortet mit 200 und leerem data.
links.last ist null, wenn die Gesamtzahl nicht bekannt ist.

Verwandte Seiten

Versionierung der Public API Fehler der Public API

Eine Liste seitenweise lesen

Fordere die erste Seite mit page=1 und dem gewünschten limit an.
Verarbeite data.
Ist links.next gesetzt, fordere diesen Link an; er behält jeden Filter der ersten Anfrage. Ist er null, war das die letzte Seite.

Code

curl --get https://api.costfluent.com/v1/budgets \
  --data page=1 --data limit=100 \
  --header "Authorization: Bearer $COSTFLUENT_API_TOKEN"

Code

{
  "links": {
    "self": "https://api.costfluent.com/v1/budgets?page=1&limit=100",
    "first": "https://api.costfluent.com/v1/budgets?page=1&limit=100",
    "prev": null,
    "next": "https://api.costfluent.com/v1/budgets?page=2&limit=100",
    "last": "https://api.costfluent.com/v1/budgets?page=3&limit=100"
  },
  "data": []
}

Operation

limit

Standard

Jede Liste, etwa Budgets, Kostenberichte oder Integrationen

1 bis 100; ein größerer oder kleinerer Wert wird auf diesen Bereich begrenzt

Kostendaten, GET /v1/costs

1 bis 5.000; ein größerer Wert wird mit 400 abgelehnt

Kostendaten in großen Mengen lesen

meta.totalRecords zählt jede Zeile, auf die die Abfrage passt; meta.totalRecords geteilt durch limit sagt dir also vorab, wie viele Seiten du erwarten kannst.