create (Links)

POST links/create

Create a link

URL:

http://mobileroadie.com/api/links/create

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.
• name
  • Required. Display name of the link.
• url
  • Required. Must be a valid URL.
• 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
• Not required.

Usage Example

<?php
 
$data = array(
  'secret' => 'your_secret_key',
  'name' => 'My Official Blog Page', 
  'url' => 'http://www.example.com/blog/', 
  'category_id' => '0',
  'sequence' => '0', 
  );
 
$handle = curl_init("https://mobileroadie.com/api/links/create/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>