API

 

/api/v2/wantlist

Request Type
GET
 
Returns a list of releases in the authenticated user's Discogs want list.
 
Example URL
https://example.stitchz.net/api/v2/wantlist?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408qq4958qw3
 
Supported Providers
 
Request
Required Parameter Type Description
yes Bearer string The application's unique Oauth2 bearer token (access token) in the request header
yes Identity string The identity string provided by Stitchz when the user logged in.
  Format string The format of the authenticated Stitchz response, XML, JSON, JSONP. A query string parameter can be included in the request (e.g. ?format=json) or a header variable of "Accept" with the proper value, e.g. 'application/json', 'application/xml', etc. The default response is in "JSON" format.
Example Request
$ curl -H "Authorization: Bearer e72e16c7e42f292c6912e7710c838347ae178b4a"
-H "Accept: application/json"
-A "example client"
https://example.stitchz.net/api/v2/wantlist?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3

GET /api/v2/wantlist?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408Rq4958qw3 HTTP/1.1
User-Agent: example client
Host: example.stitchz.net
Accept: application/json
Authorization: Bearer e72e16c7e42f292c6912e7710c838347ae178b4a
Response
The response returned contains the fields and attributes as defined by the service provider, i.e. Discogs, etc.
 
Example XML Response
Example JSON Response
<wantlist>
    <wants>
        <rating>0</rating>
         <basic_information>
            <labels>
                <id>129270</id>
                <resource_url>http://api.discogs.com/labels/129270</resource_url>
                <catno>EKS-74025</catno>
                <name>Elektra (2)</name>
                <entity_type>1</entity_type>
            </labels>
            <formats>
                <descriptions>LP</descriptions>
                <descriptions>Compilation</descriptions>
                <descriptions>Unofficial Release</descriptions>
                <name>Vinyl</name>
                <qty>2</qty>
            </formats>
            <thumb>http://api.discogs.com/image/R-150-2334309-1282652153.jpeg</thumb>
            <title>Absolutely Rare</title>
            <artists>
                <join> </join>
                <name>Doors, The</name>
                <anv> </anv>
                <tracks> </tracks>
                <role> </role>
                <resource_url>http://api.discogs.com/artists/56798</resource_url>
                <id>56798</id>
            </artists>
            <resource_url>http://api.discogs.com/releases/2334309</resource_url>
            <year>2010</year>
            <id>2334309</id>
        </basic_information>
        <notes> </notes>
        <notes_public>false</notes_public>
        <resource_url>http://api.discogs.com/users/<username>/wants/2334309</resource_url>
        <id>2334309</id>
    </wants>
    <pagination>
        <per_page>50</per_page>
        <items>5</items>
        <page>1</page>
        <urls />
        <pages>1</pages>
    </pagination>
</wantlist>
{
    "wantlist":
    {
        "wants":
        [
            {
                "rating":"0",
                "basic_information":
                {
                    "labels":
                    {
                        "id":"129270",
                        "resource_url":"http://api.discogs.com/labels/129270",
                        "catno":"EKS-74025",
                        "name":"Elektra (2)",
                        "entity_type":"1"
                    },
                    "formats":
                    {
                        "descriptions":["LP","Compilation","Unofficial Release"],
                        "name":"Vinyl",
                        "qty":"2"
                    },
                    "thumb":"http://api.discogs.com/image/R-150-2334309-1282652153.jpeg",
                    "title":"Absolutely Rare",
                    "artists":
                    {
                        "join":"",
                        "name":"Doors, The",
                        "anv":"",
                        "tracks":"",
                        "role":"",
                        "resource_url":"http://api.discogs.com/artists/56798",
                        "id":"56798"
                    },
                    "resource_url":"http://api.discogs.com/releases/2334309",
                    "year":"2010",
                    "id":"2334309"
                },
                "notes":"",
                "notes_public":"false",
                "resource_url":"http://api.discogs.com/users/<username>/wants/2334309",
                "id":"2334309"
            },
        ],
        "pagination":
        {
            "per_page":"50",
            "items":"5",
            "page":"1",
            "urls":null,
            "pages":"1"
        }
    }
}
Request Type
POST
 
Adds to the list of releases in the authenticated user's Discogs want list.
 
Example URL
https://login.stitchz.net/api/v2/wantlist?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408qq4958qw3
 
Supported Providers
Discogs supported request
 
Request
Required Parameter Type Description
yes Bearer string The application's unique Oauth2 bearer token (access token) in the request header
yes Identity string The identity string provided by Stitchz when the user logged in.
yes releaseId number The id of the release as given by the provider. Post this parameter in the body of the request when adding a release to the want list, e.g. releaseId=123456
  Format string The format of the authenticated Stitchz response, XML, JSON, JSONP. The default response is in "JSON" format.
Response
The response returned contains the fields and attributes as defined by the service provider, i.e. Discogs, etc.
 
Example XML Response
Example JSON Response
<wantlist>
    <rating>0</rating>
    <basic_information>
        <labels>
            <id>323603</id>
            <resource_url>http://api.discogs.com/labels/323603</resource_url>
            <catno>SLW-1642</catno>
            <name>World Record</name>
            <entity_type>1</entity_type>
        </labels>
        <formats>
            <descriptions>LP</descriptions>
            <descriptions>Album</descriptions>
            <descriptions>Stereo</descriptions>
            <descriptions>Unofficial Release</descriptions>
            <text>Orange</text>
            <name>Vinyl</name>
            <qty>1</qty>
        </formats>
        <thumb>http://api.discogs.com/image/R-150-4590269-1369279334-7829.jpeg</thumb>
        <title>Doors</title>
        <artists>
            <join></join>
            <name>Doors, The</name>
            <anv> </anv>
            <tracks> </tracks>
            <role> </role>
            <resource_url>http://api.discogs.com/artists/56798</resource_url>
            <id>56798</id>
        </artists>
        <resource_url>http://api.discogs.com/releases/4590269</resource_url>
        <year>1968</year>
        <id>4590269</id>
    </basic_information>
    <notes> </notes>
    <notes_public>false</notes_public>
    <resource_url>http://api.discogs.com/users/doors67/wants/4590269</resource_url>
    <id>4590269</id>
</wantlist>
{
    "wantlist":
    {
            "rating":"0",
            "basic_information":
            {
                "labels":
                {
                    "id":"129270",
                    "resource_url":"http://api.discogs.com/labels/129270",
                    "catno":"EKS-74025",
                    "name":"Elektra (2)",
                    "entity_type":"1"
                },
                "formats":
                {
                    "descriptions":["LP","Compilation","Unofficial Release"],
                    "name":"Vinyl",
                    "qty":"2"
                },
                "thumb":"http://api.discogs.com/image/R-150-2334309-1282652153.jpeg",
                "title":"Absolutely Rare",
                "artists":
                {
                    "join":"",
                    "name":"Doors, The",
                    "anv":"",
                    "tracks":"",
                    "role":"",
                    "resource_url":"http://api.discogs.com/artists/56798",
                    "id":"56798"
                },
                "resource_url":"http://api.discogs.com/releases/2334309",
                "year":"2010",
                "id":"2334309"
            },
            "notes":"",
            "notes_public":"false",
            "resource_url":"http://api.discogs.com/users/<username>/wants/2334309",
            "id":"2334309"
    }
}
Request Type
DELETE
 
Deletes the release from the list of releases in the authenticated user's Dsicogs want list.
 
Example URL
https://login.stitchz.net/api/v2/wantlist/123456?identity=http%3a%2f%2fwww.discogs.com%2fuser%2f3408qq4958qw3
 
Supported Providers
Discogs supported request
 
Request
Required Parameter Type Description
yes Bearer string The application's unique Oauth2 bearer token (access token) in the request header
yes Identity string The identity string provided by Stitchz when the user logged in.
yes releaseId number The id of the release as given by the provider. Include this value in the URL of the request at the end before the query string parameters.
  Format string The format of the authenticated Stitchz response, XML, JSON, JSONP. The default response is in "JSON" format.
Response
The response returned contains the fields and attributes as defined elow.
 
Example XML Response
Example JSON Response
<response status="ok" version="1">
    <delete>true</delete>
</response>
{
    "response":
    {
        "delete": true
    }
}