페이지네이션

​

Recent search 페이지네이션

​

소개

• recent search 엔드포인트는 쿼리에 대해 최소 한 페이지로 응답하며, 추가 페이지가 있는 경우 JSON 응답에 next_token을 제공합니다. 매칭되는 게시물을 수신하려면 응답에 토큰이 포함되지 않을 때까지 이 프로세스를 반복할 수 있습니다.
• next_token은 만료되지 않습니다. 동일한 next_token 값을 사용한 여러 요청은 요청 시점에 관계없이 동일한 결과를 반환합니다.
• 게시물은 UTC 시간대 기준 역시간순으로 전달됩니다. 이는 개별 페이지 내에서도, 여러 페이지 사이에서도 동일합니다:
  • 첫 응답의 첫 게시물이 쿼리에 매칭되는 가장 최근 게시물입니다.
  • 마지막 응답의 마지막 게시물이 쿼리에 매칭되는 가장 오래된 게시물입니다.
• max_results 요청 파라미터로 응답당 반환되는 게시물 수를 구성할 수 있습니다. 기본값은 10개이고 최대 100개입니다.
• 모든 페이지네이션 구현은 응답 페이로드에서 next_token을 파싱하고 이를 ‘다음 페이지’ 검색 요청에 포함시키는 과정을 수반합니다. 이러한 ‘다음 페이지’ 요청을 구성하는 방법에 대한 자세한 내용은 아래를 참조하세요.

• 과거 데이터 가져오기 - 관심 기간의 매칭 게시물을 요청합니다. 이는 일반적으로 과거 리서치를 지원하는 일회성 요청입니다. 검색 요청은 start_time 및 end_time 요청 파라미터를 기반으로 할 수 있습니다. recent search 엔드포인트는 가장 최근 매칭 게시물부터 시작하여 게시물을 역시간순으로 전달합니다.
• 폴링 - 마지막으로 수신한 게시물 이후 게시된 매칭 게시물을 요청합니다. 이러한 사용 사례는 거의 실시간에 초점을 맞추는 경우가 많으며, 관심 있는 새 게시물을 “청취”하며 잦은 요청이 특징입니다. Recent search 엔드포인트는 ‘폴링’ 패턴 지원을 위해 since_id 요청 파라미터를 제공합니다. Post ID로 탐색을 돕기 위해 until_id 요청 파라미터도 제공됩니다.

​

과거 데이터 조회

"meta": {
        "newest_id": "1204860593741553664",
        "oldest_id": "1204860580630278147",
        "next_token": "b26v89c19zqg8o3fobd8v73egzbdt3qao235oql",
        "result_count": 10
    }

​

폴링 및 리스닝 사용 사례

"meta": {
        "newest_id": "12000",
        "oldest_id": "10005",
        "result_count": 7
    }

"meta": {
        "newest_id": "13800",
        "oldest_id": "12500",
        "next_token": "fnsih9chihsnkjbvkjbsc",
        "result_count": 10
    }

"meta": {
        "newest_id": "12300",
        "oldest_id": "12010",
        "result_count": 8
    }