API di AffiliationSoftware

API di AffiliationSoftware

AffiliationSoftware dispone di un API (application programming interface) che consente agli sviluppatori di interfacciare il programma di affiliazione con il proprio sito e svolgere determinate azioni in modo automatico, ad esempio approvare o rifiutare le commissioni generate dagli affiliati in base allo stato dell’ordine.

API di AffiliationSoftware

Come usare l’API di AffiliationSoftware

L’API di AffiliationSoftware si può richiamare unicamente con richieste POST e utilizzando la funzione cURL di PHP. Il risultato di ogni chiamata ritorna un messaggio in formato JSON. Per funzionare basta abilitare il plugin apposito che mostra la pagina contenente la propria URL e la chiave necessaria per comunicare con il programma di affiliazione.

Pannello Admin > Impostazioni > API

Leggere una commissione
$afs_url = 'AFFILIATIONSOFTWARE_URL';
$afs_data = array(
	'afs_apikey' => 'AFFILIATIONSOFTWARE_API_KEY',
	'afs_action' => 'transaction_read',
	'afs_transaction' => 'XXX', // transactionID or orderID
);
$afs_api = curl_init( $afs_url );
curl_setopt( $afs_api, CURLOPT_POST, 1 );
curl_setopt( $afs_api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $afs_api, CURLOPT_POSTFIELDS, $afs_data );
$afs_res = curl_exec( $afs_api );
curl_close( $afs_api );
print_r( json_decode( $afs_res, true ) );

Leggere un affiliato
$afs_url = 'AFFILIATIONSOFTWARE_URL';
$afs_data = array(
	'afs_apikey' => 'AFFILIATIONSOFTWARE_API_KEY',
	'afs_action' => 'affiliate_read',
	'afs_affiliate' => 'XXX', // affiliateID, RefID or email
);
$afs_api = curl_init( $afs_url );
curl_setopt( $afs_api, CURLOPT_POST, 1 );
curl_setopt( $afs_api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $afs_api, CURLOPT_POSTFIELDS, $afs_data );
$afs_res = curl_exec( $afs_api );
curl_close( $afs_api );
print_r( json_decode( $afs_res, true ) );

Modificare lo stato di una commissione
$afs_url = 'AFFILIATIONSOFTWARE_URL';
$afs_data = array(
	'afs_apikey' => 'AFFILIATIONSOFTWARE_API_KEY',
	'afs_action' => 'transaction_edit',
	'afs_transaction' => 'XXX', // transactionID or orderID
	'afs_key' => 'status',
	'afs_value' => '1',
);
$afs_api = curl_init( $afs_url );
curl_setopt( $afs_api, CURLOPT_POST, 1 );
curl_setopt( $afs_api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $afs_api, CURLOPT_POSTFIELDS, $afs_data );
$afs_res = curl_exec( $afs_api );
curl_close( $afs_api );
print_r( json_decode( $afs_res, true ) );

Modificare lo stato di un affiliato
$afs_url = 'AFFILIATIONSOFTWARE_URL';
$afs_data = array(
	'afs_apikey' => 'AFFILIATIONSOFTWARE_API_KEY',
	'afs_action' => 'affiliate_edit',
	'afs_affiliate' => 'XXX', // affiliateID, RefID or email
	'afs_key' => 'status',
	'afs_value' => '1',
);
$afs_api = curl_init( $afs_url );
curl_setopt( $afs_api, CURLOPT_POST, 1 );
curl_setopt( $afs_api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $afs_api, CURLOPT_POSTFIELDS, $afs_data );
$afs_res = curl_exec( $afs_api );
curl_close( $afs_api );
print_r( json_decode( $afs_res, true ) );

Cancellare una commissione
$afs_url = 'AFFILIATIONSOFTWARE_URL';
$afs_data = array(
	'afs_apikey' => 'AFFILIATIONSOFTWARE_API_KEY',
	'afs_action' => 'transaction_delete',
	'afs_transaction' => 'XXX', // transactionID or orderID
);
$afs_api = curl_init( $afs_url );
curl_setopt( $afs_api, CURLOPT_POST, 1 );
curl_setopt( $afs_api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $afs_api, CURLOPT_POSTFIELDS, $afs_data );
$afs_res = curl_exec( $afs_api );
curl_close( $afs_api );
print_r( json_decode( $afs_res, true ) );

Cancellare un affiliato
$afs_url = 'AFFILIATIONSOFTWARE_URL';
$afs_data = array(
	'afs_apikey' => 'AFFILIATIONSOFTWARE_API_KEY',
	'afs_action' => 'affiliate_delete',
	'afs_affiliate' => 'XXX', // affiliateID, RefID or email
);
$afs_api = curl_init( $afs_url );
curl_setopt( $afs_api, CURLOPT_POST, 1 );
curl_setopt( $afs_api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $afs_api, CURLOPT_POSTFIELDS, $afs_data );
$afs_res = curl_exec( $afs_api );
curl_close( $afs_api );
print_r( json_decode( $afs_res, true ) );


Questo articolo è stato pubblicato da AffiliationSoftware il e modificato il 22 febbraio 2018