Difference between revisions of "Offerit REST API Click Detail"

Latest revision as of 13:46, 31 August 2018

GET /transaction/click_detail

Description

• The api/transaction/click_detail action is a feature in Offerit that allows you to retrieve details able a recent click based on the click_hash

Resource URL

• http://domain/api/transaction/click_detail
• Replace domain with the offerit domain

Request Method

• GET

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

You need to pass either transaction_hash or subscription_id or orderid for customer lookup otherwise the call will fail

• transaction_hash is used to pass in the click_hash of the click you are looking up, or the transaction_hash of an already converted transaction.
  • type: string
  • required

Example Request

GET

http://domain/api/transaction/click_detail

• Response:

true

Example Code

PHP

<?php
$curl = curl_init();

$data = array(
    'transaction_hash' => '35b71a300115be9.16738986',
);

$url = 'http://domain/api/transaction/click_detail';

$headers = array(
    'api-key: 44b5498dbcb481a0d00b404c0169af62',
    'api-username: offerit_admin'
);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_URL, $url);

$resp = curl_exec($curl);
//dumps an associative array representation of the json
var_dump(json_decode($resp, true));
// Close request to clear up some resources
curl_close($curl);
?>

Python

• This example requires pip and the request library which can be installed via pip by: 'pip install requests'

import requests
import json

url = 'http://domain/api/transaction/click_detail'

payload = {
    'transaction_hash': '35b71a300115be9.16738986',
}


headers = {
        'api-key': '44b5498dbcb481a0d00b404c0169af62',
        'api-username': 'offerit_admin'
        }

res = requests.GET(url, data=payload, headers=headers)
print res.json()

node.js

• This example requires npm and the request module which can be installed via npm by: 'npm install request'

var request = require('request');

data = {
    'transaction_hash': '35b71a300115be9.16738986',
}

var options = {
    url: 'http://domain/api/transaction/click_detail',
    method: 'GET',
    form: data,
    json: true,
    headers: {
        'api-key': '44b5498dbcb481a0d00b404c0169af62',
        'api-username': 'offerit_admin'
    }
};

function callback(error, response, body) {
    if (!error && response.statusCode == 200) {
        console.log(body);
    }
    else{
        console.log(body);
    }

}

request(options, callback);

Curl

curl -X GET 'http://domain/api/transaction/click_detail' -H "api-key: 44b5498dbcb481a0d00b404c0169af62" -H "api-username: offerit_admin" -H "Content-Type: application/x-www-form-urlencoded" -d 'transaction_hash=35b71a300115be9.16738986'