[Open API] 서비스 설치 이전 주문의 조회 가능 기간 문의

맙인

카페 매장의 주문 데이터를 분석해 메뉴·운영 컨설팅을 제공하는 서비스를 개발하고 있습니다.
매장이 서비스 코드로 저희 Open API 앱을 설치했을 때, 설치 시점 이전의 주문을 받을 수 있는지 확인하고 싶습니다.

주문 목록 조회(from/to)로 앱 설치 이전에 발생한 주문도 조회되나요???
가능하다면 최대 몇 개월(또는 며칠) 전 주문까지 조회할 수 있을까요??
한 번의 조회에서 from~to 기간의 최대 범위 제한이 있나요??
설치 직후 과거 주문을 여러 페이지로 한꺼번에 받을 때 지켜야 할 호출 횟수 제한(rate limit)이 있나요?
결제 내역도 주문과 같은 기간까지 조회할 수 있나요?

답변 감사합니다.

토스플레이스-개발자센터

안녕하세요. 토스플레이스 개발자센터입니다.

Open API 앱을 활성화하기 이전의 주문·결제 데이터도 조회할 수 있습니다. 데이터가 토스플레이스 서버에 저장되어 있으므로, 앱 설치 이후에 발생한 데이터만 조회되는 구조는 아닙니다.

1. 과거 데이터 조회 범위

앱이 연결된 매장의 서버 저장 데이터를 조회할 수 있으며, 앱 설치 시점이나 최근 몇 개월을 기준으로 조회기간을 제한하지 않습니다.

2. 한 번에 지정할 수 있는 기간

from~to 사이의 기간에 별도의 최대 일수 제한은 없습니다. 다만 두 값은 주문 생성 시각이 아니라 결제 내역이 변동된 시각을 기준으로 조회합니다. 주문 조회 가이드를 참고해 주세요.

3. 과거 주문을 여러 페이지로 조회할 때

한 페이지는 기본 100건, 최대 500건입니다. 호출량은 토큰이 최대 100개까지 충전되고 초당 10개씩 보충되는 방식으로 제한됩니다. 요청마다 토큰 1개를 사용하며, 한도를 초과하면 HTTP 429가 반환됩니다.

응답 헤더의 x-ratelimit-remaining과 x-ratelimit-reset을 확인해 호출 속도를 조정해 주세요. 호출량 제한 가이드를 참고해 주세요.

4. 결제 내역 조회

결제 내역도 앱 활성화 이전 데이터라는 이유로 조회가 제한되지는 않습니다. 주문 목록에서 주문 ID를 확인한 뒤, 주문의 결제건 모두 조회 API로 해당 주문의 결제 내역을 조회할 수 있습니다. 결제 조회 가이드를 참고해 주세요.

토스플레이스 개발자 포럼 (Beta)