DiscogsClient

Discogs클라이언트

Discogs API v2.0용 C# 클라이언트 라이브러리

데모 애플리케이션 Music.Cover.Finder 확인

특징

• 사용자 인증을 위한 API 포함(OAuth1.0 토큰 및 토큰 비밀번호 생성)
• 이미지 다운로드를 포함한 DataBase API에 대한 완벽한 지원
• ID API 지원
• 투명한 비율 제한 지원
• 태스크를 사용하는 비동기식 및 취소 가능한 API
• 비차단 API(Reactive IObservable) 또는 IEnumerable을 사용하여 페이지 매김을 투명하게 관리합니다.

샘플 사용법

Discogs 클라이언트 만들기

OAuth 인증

  //Create authentication object using private and public keys: you should fournish real keys here
  var oAuthCompleteInformation = new OAuthCompleteInformation ( " consumerKey " , 
                                  " consumerSecret " , " token " , " tokenSecret " ) ;
  //Create discogs client using the authentication
  var discogsClient = new DiscogsClient ( oAuthCompleteInformation ) ; 

토큰 기반 인증

  //Create authentication based on Discogs token
  var tokenInformation = new TokenAuthenticationInformation ( " my-token " ) ;
  //Create discogs client using the authentication
  var discogsClient = new DiscogsClient ( tokenInformation ) ; 

데이터베이스 검색

IObservable 사용:

 var discogsSearch = new DiscogsSearch ( )
{
  artist = " Ornette Coleman " ,
  release_title = " The Shape Of Jazz To Come "
} ;
    
//Retrieve observable result from search
var observable = _DiscogsClient . Search ( discogsSearch ) ;

IEnumerable 사용:

 //Alternatively retreive same result as enumerable 
var enumerable = _DiscogsClient . SearchAsEnumerable ( discogsSearch ) ; 

릴리스, 마스터, 아티스트 또는 음반사 정보 얻기

 var release = await _DiscogsClient . GetReleaseAsync ( 1704673 ) ; 

 var master = await _DiscogsClient . GetMasterAsync ( 47813 ) ; 

 var artist = await _DiscogsClient . GetArtistAsync ( 224506 ) ; 

 var label = await _DiscogsClient . GetLabelAsync ( 125 ) ; 

이미지 다운로드

 //Retrieve Release information
var res = await _DiscogsClient . GetMasterAsync ( 47813 ) ;
  
//Download the first image of the release
await _DiscogsClient . SaveImageAsync ( res . images [ 0 ] , Path . GetTempPath ( ) , " Ornette-TSOAJTC " ) ; 

OAuth: 새 사용자 승인

 //Create authentificator information: you should fournish real keys here
var oAuthConsumerInformation = new OAuthConsumerInformation ( " consumerKey " , " consumerSecret " ) ;
  
//Create Authentifier client
var discogsAuthentifierClient = new DiscogsAuthentifierClient ( oAuthConsumerInformation ) ;

//Retreive Token and Token secret 
var oauth = discogsClient . Authorize ( s => Task . FromResult ( GetToken ( s ) ) ) . Result ;

Authorize는 Func< 문자열, Task< 문자열>>을 매개변수로 사용하여 인증 URL을 수신하고 해당 액세스 키를 반환합니다. 간단한 구현:

 private static string GetToken ( string url )
{
  Console . WriteLine ( " Please authorize the application and enter the final key in the console " ) ;
  Process . Start ( url ) ;
  return Console . ReadLine ( ) ;
}

사용 가능한 API의 전체 샘플은 DiscogsClientTest 및 DiscogsAuthenticationConsole을 참조하세요.