Difference between revisions of "Offerit REST API Add Affiliate"

Revision as of 11:23, 31 May 2018

POST /affiliate/addaffiliate

Description

• To add an affiliate through the Offerit API, you can make a call to this api endpoint.

Resource URL

• http://domain/api/affiliate/addaffiliate
• Replace domain with the offerit domain

Request Method

• POST

Response Format

• JSON

Authentication

• HTTP headers

Parameters

Paremeters must be sent with the request body. The examples below show the parameters sent as x-www-form-urlencoded

• username
  • type: string
  • required
• password
  • type: string
  • required
• payvia
  • type: string
  • required
• payvia_info:(COMING SOON)
  • type: array
  • an array containing field/value pair arrays of payvia information to add for the given payvia type.
  • Must send "payvia" parameter to indicate which payvia type the payvia_info is for.
• email
  • type: string
  • required
• firstname
  • type: string
• lastname
  • type: string
• company
  • type: string
• url
  • type: string
• tel
  • type: string
• icq
  • type: string
• aim
  • type: string
• msn
  • type: string
• skype
  • type: string
• address1
  • type: string
• address2
  • type: string
• city
  • type: string
• state
  • type: string
• country
  • type: string
• zip_code
  • type: string
• tax_id_or_ssn
  • type: string
• ref
  • type: string
• minimum_payout
  • type: string
• join_ip
  • type: string
• custom1
  • type: string
  • max 255 characters
• custom2
  • type: string
  • max 255 characters
• custom3
  • type: string
  • max 255 characters
• custom4
  • type: string
  • max 255 characters
• custom5
  • type: string
  • max 255 characters

Example Request

POST http://domain/api/affiliate/addaffiliate

• $parameter set up:

// set the parameters for the api call
$data = Array(
	'username' => 'affusername',
	'password' => 'affpass',
	'email' => 'affemail@test.com',
	'payvia' => '1', // Check payvia type
	// notice the structure is an array of sub-arrays that have field/value pairs
	'payvia_info' => Array(
		Array(
			'field' => 'Pay To',
			'value' => 'Affiliate PayTo Name',
		),
		Array(
			'field' => 'Address',
			'value' => 'Affiliate Address',
		),
	),		
	
);

• Response:

[
    {
        "result": true,
        "loginid": "10"
    }
]

Example Code

PHP

<?php
$curl = curl_init();

$data = array(
    'username' => 'hello',
    'password' => 'apitest',
    'firstname' => 'hello',
    'lastname' => 'test',
    'email' => 'hello@offerit.com',
    'company' => 'Offerit',
    'url' => 'offerit.com',
    'tel' => '666-666-6666',
    'icq' => '666666666',
    'aim' => 'sixsixsix',
    'msn' => 'sixsixtysix',
    'address1' => '666 666 st',
    'address2' => '',
    'city' => 'My City',
    'state' => 'My State',
    'country' => 'USA',
    'zip_code' => '12345',
    'tax_id_or_ssn' => '54-1233245',
    'ref' => 'asdasd',
    'minimum_payout' => 50,
    'join_ip' => '192.168.1.1',
);

$url = 'http://domain/api/affiliate/addaffiliate';

$headers = array(
    'api-key: 44b5498dbcb481a0d00b404c0169af62',
    'api-username: productsupport'
);

curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));

$resp = curl_exec($curl);
//dumps an associative array representation of the json response
$output = json_decode($resp, true);
if($output !== NULL) {
	//json was valid. Dump the decoded array
	print_r($output);
}
else {
	//invalid json, just dump the raw response
	print_r($resp);
}
// Close request to clear up some resources
curl_close($curl);
?>

?>