페이지네이션
API의 목록 엔드포인트는 데이터를 페이지 단위로 반환합니다. 플랫폼에는 역사적으로 두 가지 페이지네이션 방식이 있으며, 특정 방식은 인터랙티브 레퍼런스의 엔드포인트에 명시되어 있습니다.
방식 1 — 오프셋과 X-Total-Count
오프셋 기반 클래식 페이지네이션. 요청에서 limit (페이지 크기)와 offset (건너뛸 레코드 수) 쿼리 매개변수를 사용합니다:
curl -H "Authorization: Bearer mbp_YOUR_TOKEN" "https://your-domain/api/bots/BOT_ID/subscribers?limit=50&offset=100"
전체 레코드 수는 X-Total-Count 응답 헤더로 반환됩니다. 이를 통해 페이지 수를 계산할 수 있습니다: offset이 X-Total-Count 값보다 작은 동안 offset을 limit씩 증가시키며 탐색합니다. 응답 본문은 현재 페이지의 요소 배열입니다.
방식 2 — before 커서와 has_more
시간 순으로 정렬된 피드(예: 대화 메시지)를 위한 커서 기반 페이지네이션. 요청에서 limit과 선택적 before 커서(마지막으로 받은 요소의 식별자 또는 마커)를 사용합니다:
curl -H "Authorization: Bearer mbp_YOUR_TOKEN" "https://your-domain/api/bots/BOT_ID/users/USER_ID/dialog?limit=50&before=CURSOR"
응답에는 요소 페이지와 has_more 플래그가 포함됩니다. has_more가 true인 동안 마지막으로 받은 요소의 커서를 before에 전달하며 요청을 반복합니다. has_more가 false가 되면 마지막 페이지입니다.
방식 선택
방식을 선택하는 것이 아닙니다 — 엔드포인트가 방식을 결정합니다. 참조 목록은 보통 오프셋과 X-Total-Count를 사용하고, 시간 순 피드는 before 커서와 has_more를 사용합니다. 항상 레퍼런스의 엔드포인트 페이지를 확인하세요.