문서 메뉴

공통 규칙

페이지네이션과 필터

리소스 특성에 따라 오프셋 방식과 커서 방식이 사용됩니다.

오프셋 페이지네이션

워크스페이스, 팀, 멤버, 초대, 역할과 내보내기 이력은 offsetlimit을 사용하고 응답의 page.total을 확인합니다.

  • 첫 페이지는 offset=0입니다.
  • 다음 페이지는 이전 offset + limit으로 요청합니다.
  • 항목이 변경되면 페이지 사이에 중복 또는 누락이 생길 수 있습니다.

레코드 커서

레코드와 공유 레코드는 응답의 next_token을 다음 요청에 그대로 전달합니다. 값이 null이면 마지막 페이지입니다.

필터 사용

  • 날짜는 ISO 8601 형식으로 전달합니다.
  • 배열 쿼리 파라미터는 같은 키를 반복해 전달합니다. 예: team_ids=7&team_ids=8
  • GET /labels에서 조회한 ID를 레코드의 label_ids 필터에 사용합니다.
© 2026 Return Zero, Inc.