Documentazione: API di AffiliationSoftware - AffiliationSoftware

API di AffiliationSoftware

API

AffiliationSoftware dispone di un API (Application Programming Interface) che consente agli sviluppatori di interfacciarsi con il network di affiliazione e svolgere determinate azioni in modo autonomo. È possibile ad esempio approvare o rifiutare automaticamente le transazioni degli affiliati in base allo stato dell’ordine, iscrivere automaticamente un affiliato quando si registra al tuo sito, e molto altro ancora.


Come funziona

L’API di AffiliationSoftware si può richiamare usando la funzione cURL di PHP, inviando i dati via POST. Il risultato di ogni chiamata restituisce un messaggio in JSON. Se vuoi utilizzare l’API puoi contattarci per richiedere la tua chiave. Di seguito sono elencate le azioni disponibili e i codici da usare per effettuare le chiamate API con PHP.


Approvare una transazione

$data = array(
  'action' => 'transaction_status',
  'transaction' => 'xxx', // inserisci l’ID o l’orderID della transazione 
  'status' => '1', // inserisci lo stato (1 = approvata, 2 = rifiutata)
);
$api = curl_init( 'http://esempio.com/script/api?key=xxx' ); // inserisci il tuo URL
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
print_r( json_decode( $res, true ) );


Modificare una transazione

$data = array(
  'action' => 'transaction_edit',
  'transaction' => 'xxx', // inserisci l’ID o l’orderID della transazione 
  'field' => 'orderid', // campi: status, amount, cost, orderid, channel, channel2, channel3, note
  'value' => 'xxx', // valore da inserire
  'field2' => 'channel', // facoltativo, fino a 10 campi
  'value2' => 'xxx', 
);
$api = curl_init( 'http://esempio.com/script/api?key=xxx' ); // inserisci il tuo URL 
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
print_r( json_decode( $res, true ) );


Modificare il profilo di un affiliato

$data = array(
  'action' => 'affiliate_edit',
  'affiliate' => 'xxx', // inserisci l’ID o l’email dell’affiliato
  'field' => 'status', // colonne: name, email, password, status, note
  'value' => '1', // valore da inserire
);
$api = curl_init( 'http://esempio.com/script/api?key=xxx' ); // inserisci il tuo URL 
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
print_r( json_decode( $res, true ) );


Iscrivere un nuovo affiliato

$data = array(
  'action' => 'affiliate_add',
  'name' => 'test affiliate', // obbligatorio
  'email' => 'test@test.test', // obbligatorio
  'password' => 'test123', // facoltativo
  'language' => 'it', // facoltativo
  'parent' => '', // facoltativo
);
$api = curl_init( 'http://esempio.com/script/api?key=xxx' ); // inserisci il tuo URL 
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
print_r( json_decode( $res, true ) );


Leggere i dati di un affiliato

$data = array(
  'action' => 'affiliate_data',
  'affiliate' => 'xxx', // inserisci l’ID o l’email dell’affiliato
);
$api = curl_init( 'http://esempio.com/script/api?key=xxx' ); // inserisci il tuo URL 
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
print_r( json_decode( $res, true ) );


Leggere le statistiche e le commissioni

$data = array(
  'action' => 'affiliate_stats',
  'from' => 'YYYY-MM-DD', // inserisci la data d’inizio
  'to' => 'YYYY-MM-DD', // inserisci la data d’inizio
  'affiliate' => 'xxx', // inserisci l’ID o l’email dell’affiliato (facoltativo)
  'campaign' => 'xxx', // inserisci l’ID della campagna (facoltativo)
);
$api = curl_init( 'http://esempio.com/script/api?key=xxx' ); // inserisci il tuo URL 
curl_setopt( $api, CURLOPT_POST, 1 );
curl_setopt( $api, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $api, CURLOPT_POSTFIELDS, $data );
$res = curl_exec( $api );
curl_close( $api );
print_r( json_decode( $res, true ) );

Torna indietro