문서 둘러보기

관리 주체

Spotify 앱을 만들고 OOMOL에 연결하기

OOMOL에서 Spotify에 연결하려면 자신의 OAuth 앱이 필요합니다. 개발 모드에서는 앱 소유자에게 유효한 Spotify Premium 구독이 있어야 합니다. 현재 개발 앱당 최대 5명의 인증된 사용자를 등록할 수 있습니다.

앱과 콜백 URL 설정

Spotify Developer Dashboard에 로그인하여 앱을 만들거나 관리 중인 앱을 엽니다. 이름과 설명을 입력하고 Web API를 선택합니다.

OOMOL 연결 관리에서 Spotify를 찾아 계정을 추가합니다. OAuth 설정에 표시된 전체 Redirect URI를 복사하여 Spotify의 Redirect URIs에 저장합니다. 경로와 마지막 슬래시까지 일치해야 합니다. 루프백 이외의 주소는 HTTPS를 사용해야 합니다.

계정 등록 및 연결

같은 Spotify 앱에서 Settings → Users Management → Add new user를 열어 연결할 계정의 이름과 Spotify 이메일을 입력합니다. 허용 목록에 추가되었는지 확인합니다.

앱 설정에서 Client ID와 Client Secret을 복사하여 OOMOL의 같은 이름 필드에 저장합니다. 두 값은 같은 앱에서 가져와야 합니다. 연결을 시작하고 등록한 Spotify 계정으로 로그인하여 접근을 허용합니다. OOMOL로 돌아와 프로필을 조회하여 계정을 확인합니다.

Client Secret을 비공개로 보관하세요. 이전에 OOMOL의 공유 앱으로 연결했다면 자신의 앱 자격 증명을 저장한 뒤 다시 인증하세요.

연결 문제 해결

“The user is not registered for this application” 오류가 표시되면 OOMOL에 저장한 Client ID에 해당하는 앱의 허용 목록을 확인하세요. Spotify는 로그인을 허용한 뒤 API 요청에서 403을 반환할 수 있습니다. OOMOL과 Spotify 이메일이 같아도 자동으로 등록되지 않습니다.

리디렉션 URI 오류가 발생하면 OOMOL의 주소를 그대로 다시 등록하세요. 연결 후 작업을 사용할 수 없다면 엔드포인트 제한, 승인한 권한 및 Premium 요구 사항을 확인하세요. 자신의 앱에도 개발 모드 제한이 적용됩니다.

Spotify: Apps · Spotify: Quota modes · Spotify: Redirect URIs

시작하기

시작하기