페이지네이션

API는 엔드포인트에 따라 두 가지 페이지네이션 방식을 사용합니다.

오프셋 페이지네이션

프로젝트 검색 및 버전 목록에서 사용됩니다.

쿼리 파라미터로 page를 전달하세요 (기본값 1, 최대 100). 각 페이지에는 최대 25개의 항목이 포함됩니다.

curl 'https://api.youvico.com/api/projects/:id/versions?page=2' \
  -H 'Authorization: Bearer YOUR_API_KEY'

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

hasNext가 true이면 page를 1 증가시켜 다음 결과를 가져오세요.

커서 페이지네이션

댓글 목록 및 답글 목록에서 사용됩니다.

각 응답에는 next와 prev 커서가 포함됩니다. 다음 요청에 그 중 하나를 전달하여 앞뒤로 이동하세요.

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

• null 커서는 해당 방향에 더 이상 결과가 없음을 의미합니다.
• 요청당 next 또는 prev 중 하나만 전송하세요 — 둘 다 보내면 400 에러가 반환됩니다.
• 커서 값은 불투명한 문자열로 취급하세요. 파싱하거나 직접 구성하지 마세요.

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