ページネーション

Request

page size を制御するには limit を、次の page を取得するには cursor を渡します。cursors は opaque です。parse、edit、construct しないでください。

GET /api/v1/agents?limit=50
GET /api/v1/agents?cursor=opaque_cursor_value&limit=50

Response

list responses は次の envelope を使用します。

{
  "items": [
    {}
  ],
  "pagination": {
    "nextCursor": "opaque_cursor_value"
  }
}

これ以上 page がない場合、pagination.nextCursor は null です。 totals は共通の list envelope には含まれません。

Load more loop

async function listAllAgents() {
  const agents = [];
  let cursor;

  do {
    const url = new URL("https://api.voiceagent.example/api/v1/agents");
    url.searchParams.set("limit", "50");

    if (cursor) {
      url.searchParams.set("cursor", cursor);
    }

    const response = await fetch(url, {
      headers: {
        Authorization: `Bearer ${process.env.VOICEAGENT_API_KEY}`,
      },
    });

    const body = await response.json();

    if (!response.ok) {
      throw new Error(`${response.status} ${body.error?.code}: ${body.error?.message}`);
    }

    agents.push(...body.items);
    cursor = body.pagination.nextCursor;
  } while (cursor);

  return agents;
}