View source for Offerit REST API Lock Customer

{{Offerit Manual
| show_rest_api_section = true
}}
== '''PATCH /customer/lock''' ==
'''Description''' 
*The  api/customer/lock action is a feature in Offerit that allows you to lock a customer so it can't be edited by Offerit.  It can still be updated based on posts from the advertiser. 

'''Resource URL'''
*<nowiki>http://domain/api/customer/lock</nowiki>
*Replace domain with the offerit domain

'''[[Offerit_REST_API_Overview#Allowed_HTTP_Request_Methods|Request Method''']]
*PATCH

'''Response Format'''
*JSON

'''[[Offerit_REST_API_Overview#Authentication|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 customer_id or subscription_id or orderid for customer lookup otherwise the call will fail'''

*customer_id is used to pass in the customer_id of the customer to modify
**'''''type: string'''''
**'''optional'''
*subscription_id is used to pass in the subscription of the customer to modify
**'''''type: string'''''
**'''optional'''
*orderid is used to pass in the event id of one of the transactions associated with the customer to modify
**'''''type: string'''''
**'''optional'''

== '''Example Request''' ==

'''PATCH'''

<nowiki>http://domain/api/customer/lock</nowiki>

*Response: 
<pre>
true
</pre>

== '''Example Code''' ==

'''PHP'''
<pre>
<?php
$curl = curl_init();

$data = array(
    'customer_id' => 191,
);

$url = 'http://domain/api/customer/lock';

$headers = array(
    'api-key: 44b5498dbcb481a0d00b404c0169af62',
    'api-username: offerit_admin'
);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "PATCH");
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);
?>
</pre>

'''Python'''
*This example requires pip and the request library which can be installed via pip by: 'pip install requests'
<pre>
import requests
import json

url = 'http://domain/api/customer/lock'

payload = {
    'customer_id': 191,
}


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

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


</pre>

'''node.js'''
*This example requires npm and the request module which can be installed via npm by: 'npm install request'
<pre>
var request = require('request');

data = {
    'customer_id': 191,
}

var options = {
    url: 'http://domain/api/customer/lock',
    method: 'PATCH',
    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);

</pre>

'''Curl'''
<pre>
curl -X PATCH 'http://domain/api/customer/lock' -H "api-key: 44b5498dbcb481a0d00b404c0169af62" -H "api-username: offerit_admin" -H "Content-Type: application/x-www-form-urlencoded" -d 'customer_id=191'
</pre>


[[Category:Offerit API Articles]]