Beim Abrufen von Daten über die Aircall API geben Listenendpunkte Ergebnisse mithilfe von Pagination zurück. Dieser Ansatz hilft dabei, große Datenmengen zu verwalten, indem Antworten in mehrere Seiten aufgeteilt und Navigationsinformationen für jede Seite bereitgestellt werden.

Grundlagen der Pagination

Die Paginierungsinformationen sind im meta-Objekt der API-Antwort enthalten. Dieses Objekt liefert wichtige Informationen zum aktuellen Datensatz und zur Navigation:

  • count: Anzahl der Elemente auf der aktuellen Seite

  • total: Gesamtanzahl der Elemente, die der Abfrage entsprechen

  • current_page: Aktuelle Seitennummer

  • per_page: Anzahl der pro Seite zurückgegebenen Elemente

  • next_page_link / previous_page_link: Links zur Navigation zwischen den Seiten

Die Pagination kann über folgende Abfrageparameter gesteuert werden:

  • page: Seitennummer (Standard: 1)

  • per_page: Anzahl der Ergebnisse pro Seite (Standard: 20, Maximum: 50)

Beispiel

GET /v1/calls?page=2&per_page=50

Limit von 10.000 Datensätzen

Aus Leistungsgründen sind Listenendpunkte in der Aircall API auf maximal 10.000 Datensätze pro Abfrage begrenzt, auch wenn Pagination verwendet wird.

Dieses Limit gilt für Endpunkte, die Sammlungen von Ressourcen zurückgeben, darunter:

  • Alle Anrufe auflisten

  • Alle Kontakte auflisten

  • Andere ähnliche Listenendpunkte

Wenn mehr als 10.000 Datensätze einer Anfrage entsprechen, gibt die API nur die ersten 10.000 Ergebnisse zurück. Seiten außerhalb dieses Bereichs sind nicht zugänglich.

Achtung: Paginierungsparameter wie page und per_page umgehen das Limit von 10.000 Datensätzen nicht.

Mehr als 10.000 Datensätze abrufen

Um größere Datenmengen abzurufen, teilen Sie Ihre Anfragen mithilfe verfügbarer Filter auf, beispielsweise durch zeitbasierte Parameter.

Der Endpunkt /v1/calls unterstützt zum Beispiel:

  • from: Minimales Erstellungsdatum des Anrufs (UNIX-Zeitstempel)

  • to: Maximales Erstellungsdatum des Anrufs (UNIX-Zeitstempel)

Durch Abfragen kleinerer Zeiträume, etwa wöchentlicher oder monatlicher Intervalle, bleibt jede Anfrage unter dem Limit von 10.000 Datensätzen und ermöglicht dennoch den vollständigen Datenabruf.

Beispiel

GET /v1/calls?from=<timestamp>&to=<timestamp>
Tipp: Teilen Sie große Abfragen in kleinere Zeitfenster auf, damit jede Anfrage innerhalb des Limits von 10.000 Datensätzen bleibt.

Zusätzliche Hinweise

  • Der maximale Wert für per_page beträgt 50.

  • Paginierungsparameter ermöglichen keinen Zugriff auf mehr als 10.000 Datensätze.

  • Einige Endpunkte, wie beispielsweise Anrufe, können zusätzliche Einschränkungen enthalten, etwa eine begrenzte historische Verfügbarkeit.