Paginierung mit dem Vonage Client SDK

Product deprecation notice

Effective April 30th, 2026, Vonage In-App Messaging will no longer be available. Access for new users will be closed, and the service will be discontinued for all existing users.

If you have any questions regarding this product’s discontinuation, please contact your account manager or our support team.

Wenn Sie eine Liste von Objekten mit dem Vonage Client SDK abrufen, wird die Antwort paginiert. Das bedeutet, dass nicht alle Objekte auf einmal zurückgegeben werden, was die Latenzzeit und die Größe der Antwort erhöhen würde, sondern Sie erhalten einen Teil der Antwort oder eine Seite. Zum Beispiel kann der Aufruf getConversations gibt eine ConversationsPage.

Funktionen, die eine Seite zurückgeben, haben Parameter für eine Seitengröße und einen Cursor. Durch die Angabe eines Cursors können Sie die Seiten durchlaufen, bis Sie alle Ergebnisse erhalten. Hier ist ein Beispiel für die Abfrage von Gesprächen.

let conversations, nextCursor, previousCursor
const params = {
    order: "asc", // "desc"
    pageSize: 5,
    cursor: null,
    includeCustomData: true,
    orderBy: null // "CUSTOM_SORT_KEY"     
};

client.getConversations(params)
    .then(conversationsPage => {
        ({conversations, nextCursor, previousCursor} = conversationsPage);
        console.log("Array of Conversations: ", conversations);
        console.log("Cursor for next set of results, if any. Could be null: ", nextCursor);
        console.log("Cursor for previous set of results, if any. Could be null: ", previousCursor);
    }).catch(error => {
        console.error("Error getting Conversations: ", error);
    });

Auf der ConversationsPage gibt es eine nextCursor und previousCursor Parameter. Um die nächste Seite von Conversations zu erhalten, rufen Sie getConversations erneut, aber dieses Mal mit dem Wert aus dem aktuellen ConversationsPage.nextCursor für den Cursor:

const params = {
    order: "asc", // "desc"
    pageSize: 5,
    cursor: nextCursor, // previousCursor
    includeCustomData: true,
    orderBy: null // "CUSTOM_SORT_KEY"     
};

client.getConversations(params)
    ...

Wenn Sie das Ende der Ergebnisse erreicht haben, nextCursor ist null/null. Umgekehrt, wenn Sie den Anfang der Ergebnisse erreichen previousCursor wird null/null sein.