Paginierung

Paginierung einer Ressource verläuft immer über die gleichen 2 Parameter, page und per.

page gibt den offset an, wie viele Ressourcen in einer Liste übersprungen werden. Standardmäßig beträgt der Wert 1. Wie viele übersprungen werden, hängt vom 2. Parameter per ab.

per gibt an, wie viele Ressourcen pro Seite aufgerufen werden. Dieser Parameter sollte möglichst klein bleiben, um die Ladezeit der Abfrage so gering wie möglich zu halten. Standardmäßig beträgt der Wert dafür 20 oder 25. Der Wert sollte aber in der Regel nicht mehr als 500 betragen, um mögliche Timeouts zu vermeiden.

Das heißt, beim Aufrufen der Objekte werden standardmäßig die ersten 20 Objekte zurückgegeben. Wenn man mehr braucht, setzt man entweder das per höher oder man macht mehrere Requests mit page 1, 2, usw.

Bei Objekten, Kontakten, Suchprofilen, Deals, Terminen, Aufgaben wird Paginierung verwendet.