package discogs import ( "strconv" ) // CollectionService is an interface to work with collection. type CollectionService interface { // Retrieve a list of folders in a user’s collection. // If folder_id is not 0, authentication as the collection owner is required. CollectionFolders(username string) (*CollectionFolders, error) // Retrieve a list of items in a folder in a user’s collection. // If folderID is not 0, authentication with token is required. CollectionItemsByFolder(username string, folderID int, pagination *Pagination) (*CollectionItems, error) // Retrieve the user’s collection folders which contain a specified release. // The releaseID must be non-zero. CollectionItemsByRelease(username string, releaseID int) (*CollectionItems, error) // Retrieve metadata about a folder in a user’s collection. Folder(username string, folderID int) (*Folder, error) } type collectionService struct { url string } func newCollectionService(url string) CollectionService { return &collectionService{ url: url, } } // Folder serves folder response from discogs. type Folder struct { ID int `json:"id"` Count int `json:"count"` Name string `json:"name"` ResourceURL string `json:"resource_url"` } func (s *collectionService) Folder(username string, folderID int) (*Folder, error) { if username == "" { return nil, ErrInvalidUsername } var folder *Folder err := request(s.url+"/"+username+"/collection/folders/"+strconv.Itoa(folderID), nil, &folder) return folder, err } // CollectionFolders serves collection response from discogs. type CollectionFolders struct { Folders []Folder `json:"folders"` } func (s *collectionService) CollectionFolders(username string) (*CollectionFolders, error) { if username == "" { return nil, ErrInvalidUsername } var collection *CollectionFolders err := request(s.url+"/"+username+"/collection/folders", nil, &collection) return collection, err } // CollectionItemSource ... type CollectionItemSource struct { ID int `json:"id"` BasicInformation BasicInformation `json:"basic_information"` DateAdded string `json:"date_added"` FolderID int `json:"folder_id,omitempty"` InstanceID int `json:"instance_id"` Notes []Note `json:"notes,omitempty"` Rating int `json:"rating"` } // BasicInformation ... type BasicInformation struct { ID int `json:"id"` Artists []ArtistSource `json:"artists"` CoverImage string `json:"cover_image"` Formats []Format `json:"formats"` Labels []LabelSource `json:"labels"` Genres []string `json:"genres"` MasterID int `json:"master_id"` MasterURL *string `json:"master_url"` ResourceURL string `json:"resource_url"` Styles []string `json:"styles"` Thumb string `json:"thumb"` Title string `json:"title"` Year int `json:"year"` } // Note ... type Note struct { ID int `json:"field_id"` Value string `json:"value"` } // CollectionItems list of items in a user’s collection type CollectionItems struct { Pagination Page `json:"pagination"` Items []CollectionItemSource `json:"releases"` } // valid sort keys // https://www.discogs.com/developers#page:user-collection,header:user-collection-collection-items-by-folder var validItemsByFolderSort = map[string]struct{}{ "": struct{}{}, "label": struct{}{}, "artist": struct{}{}, "title": struct{}{}, "catno": struct{}{}, "format": struct{}{}, "rating": struct{}{}, "added": struct{}{}, "year": struct{}{}, } func (s *collectionService) CollectionItemsByFolder(username string, folderID int, pagination *Pagination) (*CollectionItems, error) { if username == "" { return nil, ErrInvalidUsername } if pagination != nil { if _, ok := validItemsByFolderSort[pagination.Sort]; !ok { return nil, ErrInvalidSortKey } } var items *CollectionItems err := request(s.url+"/"+username+"/collection/folders/"+strconv.Itoa(folderID)+"/releases", pagination.params(), &items) return items, err } func (s *collectionService) CollectionItemsByRelease(username string, releaseID int) (*CollectionItems, error) { if username == "" { return nil, ErrInvalidUsername } if releaseID == 0 { return nil, ErrInvalidReleaseID } var items *CollectionItems err := request(s.url+"/"+username+"/collection/releases/"+strconv.Itoa(releaseID), nil, &items) return items, err }