OpenDiscogs API 사용 가이드

Discogs의 아티스트, 레이블, 릴리스 정보를 조회하는 API입니다. DSUB에서 운영하며, DSUB 회원은 개인 액세스 토큰으로 이용할 수 있습니다.

Discogs의 월별 공개 데이터 덤프를 사용합니다. 공식 API를 실시간으로 호출하거나 중계하지 않으므로, Discogs 사이트의 최신 정보와 차이가 있을 수 있습니다.

토큰은 계정당 하나만 사용할 수 있습니다. 토큰을 분실했다면 재생성해야 합니다.

회원당 요청 한도는 60초에 120회입니다. 허용된 첫 API 요청을 기준으로 60초 동안 집계하며, 토큰을 재생성해도 누적 횟수는 초기화되지 않습니다.

회원 한도와 함께 IP당 10초에 60회, 토큰당 60초에 240회의 남용 방지 제한이 적용됩니다. 어느 한도든 도달하면 추가 요청이 제한됩니다.

한도를 넘으면 429 응답을 받습니다. Retry-After 헤더가 있으면 표시된 시간(초)이 지난 뒤 다시 요청합니다.

허용된 API 요청은 캐시 응답이나 이후 서버 오류 여부와 관계없이 횟수에 포함됩니다. API 문서 열람은 회원 한도에 포함되지 않습니다.

서비스 이용에는 DSUB 이용약관이 적용됩니다. 무단 접근, 보안 우회, 자동화 남용은 금지됩니다. 비정상적인 트래픽으로 서비스 운영이나 다른 사용자의 이용을 방해해서는 안 됩니다.

약관 위반이 합리적으로 의심되거나 확인된 경우 계정이나 API 접근을 제한할 수 있습니다.

API 문서에서 엔드포인트별 요청 예제와 응답 형식을 확인하고, 직접 요청을 실행할 수 있습니다.

OpenDiscogs는 Discogs 공식 API가 아닙니다. Discogs 공식 API보다 다소 완화된 요청 제한 정책을 제안하는 프로젝트입니다. 프로젝트와 관련해 금전적 대가나 서비스 제공 제안을 받은 적은 없습니다.