Preferences: Save All User Options

• URL: https://api.promoonly.com/user/save
• Call Type: POST
• Header encoding: Base64
• Data return format: JSON

• userid: Integer - POOL User ID
• name_first: String - first name
• name_last: String - last name
• company: String - organization name
• phone: String - phone number
• title: String - title within your organization
• industry: String - selected DJ industry
• alias: String - DJ alias
• format_audio: Integer - id for default audio file type
• format_video: Integer - id for default video file type
• location_download: String - file location where downloaded files will save
• location_report: String - file location of report session files
• report_opt: Integer - activates/deactivates automatic session reporting
• file_name_01: Integer - id for filename type
• file_name_01_modifier: Integer - id for filename modifier
• file_name_02: Integer - id for filename type
• file_name_02_modifier: Integer - id for filename modifier
• file_name_03: Integer - id for filename type
• file_name_03_modifier: Integer - id for filename modifier
• file_name_04: Integer - id for filename type
• file_name_04_modifier: Integer - id for filename modifier
• file_name_05: Integer - id for filename type
• file_name_05_modifier: Integer - id for filename modifier
• file_name_spaces: Binary (0/1) - includes/excludes spaces in filename
• file_name_caps: Binary (0/1) - filename in CAPS
• hide_format: Integer - Format ID for a release format
• show_format: Integer - Format ID for a release format
• filter: Comma Separated String
  1. Top 40, (0=hide, 1=show)
  2. Urban, (0=hide, 1=show)
  3. Electronic, (0=hide, 1=show)
  4. Dance, (0=hide, 1=show)
  5. Latin, (0=hide, 1=show)
  6. Country, (0=hide, 1=show)
  7. Rock, (0=hide, 1=show)
  8. Christian, (0=hide, 1=show)
  9. Audio, (0=hide, 1=show)
  10. Video, (0=hide, 1=show)
  11. HD, (0=hide, 1=show)
  12. Content Warnings, (0=hide, 1=show)
  13. Only Singles, (0=hide, 1=show)
  14. Alternative, (0=hide, 1=show)
  15. Specialty Releases, (0=hide, 1=show)
  16. Noteworthy Only, (0=hide, 1=show)
• notifications: Integer - (0=never, 1=instant, 2=daily)
• show_singles: Binary (0/1) - (0=hide, 1=show)
• dj_program: Integer
  • 0: Serato DJ
  • 2: Traktor
  • 3: Virtual DJ

1. userid: integer
2. token: string

• alias: String
• company: String
• dj_program: Integer
• file_name: Comma Separated String
• filters: Comma Separated String
• format_audio: Integer
• format_video: Integer
• hide_formats: Comma Separated String
• id: Integer
• industry: String
• location_download: String
• location_report: String
• name_first: String
• name_last: String
• notifications: Integer
• phone: String
• report_opt: Binary (0/1)
• show_formats: Comma Separated String
• show_singles: Binary (0/1)
• title: String

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)