모티메이트: 공개 API 사용에 제한이 있나요?

요금 한도

API는 10분당 1200건의 요청으로 속도 제한을 두고 운영됩니다. 즉, 10분 동안 초당 최대 2건의 요청을 보낼 수 있습니다. 이 한도는 개별 엔드포인트에 계산되는 것이 아니라 모든 엔드포인트에서 공유된다는 점에 유의하세요.

이 한도를 초과하면 요청 수가 너무 많다는 429 응답을 받게 됩니다.

현재 요금 제한 상태는 RateLimit 헤더에서 확인할 수 있습니다.

예시:

RateLimit: limit=1200, 남은=956, 재설정=543

참조 IETF 초안 을 참조하세요.

이 한도에 도달하는 데 문제가 있는 경우 다시 한도 아래로 내려갈 수 있도록 요청 사이에 대기 시간을 설정해 주세요.

필터 / 경로 인수

경로 인수를 사용하여 필터링할 때는 호출당 인자 (예: 사용자 ID)가 50개로 제한됩니다.

페이지 매김

페이지당 최대 결과는 50개입니다. 페이지 및 페이지별 쿼리 매개변수를 사용하여 추가 결과를 가져오세요.

 

예시:

/users?page=3&per_page=30

페이지 매김 제한이 있는 API에서 모든 데이터를 가져오는 방법은 무엇인가요?
참고: 이 예에서는 GET /groups를 사용하지만 다른 엔드포인트에서도 단계를 반복할 수 있습니다.

1.  

   1. 모든 데이터를 가져옵니다:

      FOR I IN {1..NUMBER_OF_PAGES}; do
      
          curl -X GET "https://motimateapp.com/public_api/groups?page=$i"
      
          done

   2. 머신에 데이터를 저장합니다.
       

   3. 마지막 가져오기(예: 하루 전) 이후에 업데이트되거나 생성된 리소스만 가져와서 이미 가지고 있는 데이터에 병합합니다:

      
        curl -X GET "https://motimateapp.com/public_api/groups?filter[created_at_gt]=<ONE_DAY_AGO>"
      
        curl -X GET "https://motimateapp.com/public_api/groups?filter[updated_at_gt]=<ONE_DAY_AGO>"
      
        

   4. 삭제 요청을 수행할 때마다 복사본에서 리소스를 제거합니다.
       
   5. 주기적으로(예: 매주) 모든 데이터를 다시 가져와 사본을 업데이트하여 재동기화를 수행합니다.