NATS For Networks REST Store IPS

From TMM Wiki
Revision as of 15:52, 19 April 2017 by Tmmdavid (talk | contribs) (Created page with "{{NATS For Networks Manual | show_api_admin_section = true }} == '''PATCH /offer/store_offer_ips''' == '''Description''' *store_offer_ips edits the allowed ips for an existi...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Template:NATS For Networks Manual

PATCH /offer/store_offer_ips

Description

  • store_offer_ips edits the allowed ips for an existing landing page


Resource URL

  • http://domain/api/offer/store_offer_ips
  • Replace domain with the NATS For Networks domain

Response Format

  • JSON

Request Method

  • PATCH

Authentication

  • HTTP headers

Parameters

  • ips
    • type: Array
    • required
    • possible keys: postback_ips, void_ips, hostnpost_ips
    • Array containing at least one of the possible keys above specifying what type of ips to update. The value will be either a comma separate list or an array of ips to store for that type.
  • targets
    • type: Array
    • required
    • possible keys: advertiserids, offerids, landing_pageids
    • Array containing at least one of the possible keys above specifying landing pages to apply the ips to. The value will be either a comma separate list or an array of offer ids, landing page ids, or advertiser ids .

If you pass offer ids, all landing pages in those offers will be affected. If you pass advertiser ids, all landing pages of all offers associated with those advertisers will be affected.



Example Request

PATCH


http://domain/api/offer/store_offer_ips
targets[landing_pageids] = 1,2,3
ips[postback_ips] = 1.1.1.1,2.2.2.2,3.3.3.3
ips[void_ips] = 1.1.1.1,2.2.2.2,3.3.3.3


  • Response:
{
	"result":"Success","message":{
		"1":{
			"postback_ips":{
					"1.1.1.1":true,
					"2.2.2.2":true,
					"3.3.3.3":true
			},
			"void_ips":{
					"1.1.1.1":true,
					"2.2.2.2":true,
					"3.3.3.3":true
			}
		},
		"2":{
			"postback_ips":{
					"1.1.1.1":true,
					"2.2.2.2":true,
					"3.3.3.3":true
			},
			"void_ips":{
					"1.1.1.1":true,
					"2.2.2.2":true,
					"3.3.3.3":true
			}
		},
		"3":{
			"postback_ips":{
					"1.1.1.1":true,
					"2.2.2.2":true,
					"3.3.3.3":true
			},
			"void_ips":{
					"1.1.1.1":true,
					"2.2.2.2":true,
					"3.3.3.3":true
			}
		},		
		
}
		

Example Code

PHP

<?php 
$url = 'http://domain/api/offer/store_offer_ips';
$curl = curl_init(); 
 
$headers = array( 
    'api-key: 44b5498dbcb481a0d00b404c0169af62', 
    'api-username: productsupport' 
);

 $data = Array(
    'targets' => Array('landing_pageids' => "1,2,3"),
    'ips' => Array(
        'postback_ips' => "1.1.1.1,2.2.2.2,3.3.3.3",
        'void_ips' => "1.1.1.1,2.2.2.2,3.3.3.3",
    ),

); 

curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); 
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); 
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
                                                  
$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); 
?>