공통 규칙
페이지네이션과 필터
리소스 특성에 따라 오프셋 방식과 커서 방식이 사용됩니다.
오프셋 페이지네이션
워크스페이스, 팀, 멤버, 초대, 역할과 내보내기 이력은 offset과 limit을 사용하고 응답의 page.total을 확인합니다.
- 첫 페이지는
offset=0입니다. - 다음 페이지는 이전
offset + limit으로 요청합니다. - 항목이 변경되면 페이지 사이에 중복 또는 누락이 생길 수 있습니다.
레코드 커서
레코드와 공유 레코드는 응답의 next_token을 다음 요청에 그대로 전달합니다. 값이 null이면 마지막 페이지입니다.
필터 사용
- 날짜는 ISO 8601 형식으로 전달합니다.
- 배열 쿼리 파라미터는 같은 키를 반복해 전달합니다. 예:
team_ids=7&team_ids=8 GET /labels에서 조회한 ID를 레코드의label_ids필터에 사용합니다.