Listings: Specialty Decades

Tracks that are a part of specialty releases can be viewed by the decade that they were originally released. In order to facilitate that view, this end point will return the decades that are available to view those tracks by.

Specialty Decades Specification

Parameters: Header variables:
  1. userid: integer
  2. token: string
JSON list returned:

Specialty Decades Workflow

  1. URL: https://api.promoonly.com/specialty/decades
  2. Header: Authorization: Bearer Base64(userid:token)
  3. Method: GET
  4. Returned: JSON

    Example JSON Output

    [
        {
            "decade": 1940,
            "label": "1940's"
        },
        {
            "decade": 1950,
            "label": "1950's"
        },
        {
            "decade": 1960,
            "label": "1960's"
        },
        {
            "decade": 1970,
            "label": "1970's"
        },
        {
            "decade": 1980,
            "label": "1980's"
        },
        {
            "decade":1990,
            "label": "1990's"
        },
        {
            "decade": 2000,
            "label": "2000's"
        },
        {
            "decade": 2010,
            "label": "2010's"
        }
    ]

Examples

  1. PHP (using cURL):

    <?php
        $userid = 1;
        $token = "8b26e1e4f3f5e00a888807e605565c47";

        $specialty_url = "https://api.promoonly.com/specialty/decades";

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $specialty_url);
        curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer ".base64_encode($userid.":".$token)));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        $specialty_result = curl_exec($ch);
        curl_close($ch);

        $specialty_obj = json_decode($specialty_result);
    ?>
  2. Javascript (using jQuery):

    function b64EncodeUnicode(str)
    {
        return btoa(encodeURIComponent(str).replace(/%([0-9A-F]{2})/g,
            function toSolidBytes(match, p1)
            {
                return String.fromCharCode('0x' + p1);
            }));
    }

    var userid = 1;
    var token = "8b26e1e4f3f5e00a888807e605565c47";
    var auth_str = "Bearer " + b64EncodeUnicode(userid + ":" + token);

    $.ajax({
        type: "GET",
        url: "https://api.promoonly.com/specialty/decades",
        headers: { "Authorization": auth_str },
        dataType: "json",
        success: function (data)
        {
            console.log(data);
        }
    });
  3. Python (using requests):

    #!/usr/bin/env python

    import requests
    import base64
    import urllib

    userid = 1
    token = "8b26e1e4f3f5e00a888807e605565c47"

    b64_key = base64.b64encode("%s:%s" % (userid, token))
    headers = {"Authorization": "Bearer %s" % b64_key}
    specialty_url = "https://api.promoonly.com/specialty/decades"
    result_return = requests.get(specialty_url, headers=headers)

    print(result_return.text)