이 도움말에는 Vimeo API와의 상호 작용과 사용 모범 사례가 포함되어 있습니다.
이 도움말에서는 다음에 대해 알아봅니다.
응답 캐시에 저장하기
Vimeo의 대부분의 메타데이터는 동영상 이름이나 설명 및 임베드 코드 등과 같이 자주 변경되지 않습니다. 가능한 경우 개발자는 이러한 응답을 캐시에 저장하고 캐시로부터 서브해야 하며 새로운 메타 데이터가 필요하거나 예상되는 경우에만 API에 요청해야 합니다. If-Modified-Since 헤더와 같은 매개 변수를 구현하면 이 영역에서 도움이 될 수 있습니다. 'If-Modified-Since 헤더 사용'에 대한 자세한 내용은 당사의 개발자 페이지에서 확인하세요.
필드 필터 사용하기
Vimeo로 들어오는 많은 요청은 많은 양의 파이어호스 데이터를 반환하며 특정 정보만을 필요로 하는 경우에는 효율적이지 않습니다. 필드 매개 변수를 사용하여 응답에서 필요한 것을 정확하게 지정하면 서버의 워크로드가 줄어들고 API의 응답 시간이 늘어납니다. '필드 매개 변수 사용'에서 자세히 알아보세요. 또한 필드 매개 변수를 사용하면 더 높은 요청수 제한을 부여합니다.
요청수 제한 준수하기
Vimeo는 모든 개발자에게 안정적인 플랫폼을 보장하기 위해 요청수를 제한합니다. 애플리케이션이 요청수 제한을 초과하면 API는 HTTP 429 오류를 반환합니다. 개발자는 이를 예상하고 요청수 제한이 해제될 때까지 API로의 요청을 중단해야 합니다. '요청수 제한 작업'을 참고하세요.
스크래핑 방지하기
스크래핑은 웹페이지를 로드하고 페이지에서 원하는 데이터를 가져오기 위해 스크립트를 실행하여 웹사이트에서 데이터를 추출하는 작업입니다.
개발자는 데이터를 얻기 위해 스크래핑하기보다는 Vimeo의 API 중 하나를 사용해야 합니다. 사이트를 스크래핑하는 것보다 Vimeo의 API를 구현하는 것이 더 쉽고 빠릅니다.
서버에서 Vimeo를 스크래핑하고 과도한 트래픽을 전송하면 해당 서버의 IP 주소가 예고 없이 차단될 수 있습니다. 서버의 IP 주소가 차단된 것으로 판단되면 추가 정보와 함께 지원팀에 문의하십시오.
공개적으로 문서화된 API만 사용하기
대담한 개발자는 메타 태그, 구성 파일 또는 Vimeo에서 데이터를 가져오는 데 사용된 기타 API를 찾을 수 있습니다. 이 분야에 정통한 사용자라면 액세스할 수 있는 내용이지만 Vimeo는 개발자에게 개발자 사이트에 기록된 공개 API만 사용하도록 요청합니다. 이러한 내부 API는 타사에서 사용하기 위한 것이 아니며 언제든지 예고 없이 변경될 수 있습니다.