update (Discography)

POST discography/update

Update a discography item

URL:

http://mobileroadie.com/api/discography/update

Formats

XML, JSON, HTML

Requirements

SSL, API Secret, White-Listed IP Address

HTTP Method(s):

POST

URL Parameter(s):

• key
  • Required

POST Parameters:

• secret
  • Required.
• id
  • Required. Id of existing discography entry.
• title
  • Required. Album name.
• record_label
  • Name of the Record Label for the album
• release_year
  • 4 digit year in which the album was released (Example: 2014)
• description
  • Required. Description of the Album. This field can accept HTML.
• url_itunes
  • URL to purchase for iPhone apps.
• 7digital_url
  • URL to purchase for Android apps (7digital or other URL).
• image_url
  • Full URL to a image of the speaker.
• sequence
  • Required. Must be a natural, positive number (0, 1, 2, 3, etc.), which will be used to determine the display order. The numbers do not need to be unique, so if sort order is not important the same number can be used for each entry.
• category_id
  • Category ID to assign to this content

Usage Example

<?php
 
$data = array(
  'secret' => 'your_secret_key',
  'id' => '12345', 
  'title' => 'Album 2', 
  'record_label' => 'Mobile Roadie Records', 
  'release_year' => '2014', 
  'description' => 'The Best Album Ever',
  'url_itunes' => 'http://itunes.apple.com/us/artist/the-bloody-beetroots/id266798981',
  '7digital_url' => 'http://url.to.song',
  'sequence' => '1',
  'image_url' => 'http://url.to.image',
  'category_id' => '1'
  );
 
$handle = curl_init("https://mobileroadie.com/api/discography/update/key/4d4ba30d73b77f7");
curl_setopt($handle, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
curl_setopt($handle, CURLOPT_POST, true);
curl_setopt($handle, CURLOPT_POSTFIELDS, $data);
$response = curl_exec($handle);
curl_close($handle);
 
?>

Success Response

<xml>
 
<id>1234567890</id>
</xml>

Response when Missing Required Fields

<xml>
 
<error>[FieldName1] is required. [FieldNameX] is required.</error>
</xml>