Preferences: Save All User Options

User options can be saved by groups, or through this endpoint that saves all user options in a single call. Fields that are left null will not be modified. It is recommended to save items by their corresponding smaller group calls.

Save All User Options Specification

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

Save All User Options Workflow

  1. URL: https://api.promoonly.com/user/save
  2. Header: Authorization: Bearer Base64(userid:token)
  3. Method: POST
  4. Returned: JSON

    Example JSON Output

    {
        "alias": "DJ POOL Test",
        "company": "Promo Only",
        "dj_program": null,
        "error": "Invalid Hide Format ID: ",
        "file_name": null,
        "filters": "",
        "format_audio": 1,
        "format_video": 1,
        "hide_formats": "",
        "id": 1,
        "industry": "Radio/Broadcast",
        "location_download": "/Users/test/Music",
        "location_report": "",
        "name_first": "POOL",
        "name_last": "User",
        "notifications": 1,
        "phone": "407-331-3600",
        "report_opt": null,
        "show_formats": "1",
        "show_singles": null,
        "title": "Test User"
    }

Examples

  1. PHP (using cURL):

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

        $api_url = "https://api.promoonly.com/user/save";
        $post_fields = "userid=1&name_last=Test&name_first=POOL&phone=407-331-3600&show_format=1¬ifications=1";

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $api_url);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_fields);
        curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer ".base64_encode($userid.":".$token)));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

        $api_obj = json_decode($api_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: "POST",
        url: "https://api.promoonly.com/user/save",
        headers: { "Authorization": auth_str },
        data: { userid: 1, name_last: "Test", name_first: "POOL", phone: "407-331-3600", show_format: 1, notifications: 1 },
        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"
    post_data = { "userid": 1, "name_last": "Test", "name_first": "POOL", "phone": "407-331-3600", "show_format": 1, "notifications": 1 }

    b64_key = base64.b64encode("%s:%s" % (userid, token))
    headers = {"Authorization": "Bearer %s" % b64_key}
    api_url = "https://api.promoonly.com/user/save"
    result_return = requests.post(api_url, headers=headers, data=post_data)

    print(result_return.text)