ページネーション

APIはエンドポイントに応じて2種類のページネーションを使用します。

オフセットページネーション

プロジェクト検索 で使用します。

クエリパラメータとして page を渡します（デフォルト 1、最大 100）。各ページには最大 25 件が含まれます。

curl 'https://api.youvico.com/api/projects.search?query=launch&page=2' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [...],
  "page": {
    "current": 2,
    "hasNext": true
  }
}

hasNext が true の場合、page を増やして次の結果セットを取得します。

カーソルページネーション

コメント一覧 と 返信一覧 で使用します。

各レスポンスには next と prev カーソルが含まれます。次のリクエストでどちらか一方を渡すことで、前後に移動できます。

{
  "data": [...],
  "page": {
    "next": "MjAyNi0wNC0xMFQwODowMDowMC4wMDBa",
    "prev": null
  }
}

• null カーソルは、その方向にこれ以上結果がないことを意味します。
• 1回のリクエストでは next または prev の どちらか一方だけ を送信してください。両方を送ると 400 エラーになります。
• カーソル値は不透明な文字列として扱ってください。解析したり自分で生成したりしないでください。

curl 'https://api.youvico.com/api/files/:id/comments?next=MjAyNi0wNC0xMFQwODowMDowMC4wMDBa' \
  -H 'Authorization: Bearer YOUR_API_KEY'