NATS4 REST API Set Member Details
From TMM Wiki
Revision as of 19:12, 26 March 2015 by Tmmtobias0185 (talk | contribs)
PATCH /member/setdetails
Description
- The /member/setdetails action is a feature in NATS4 that allows you to set the member details for a NATS member.
Resource URL
- http://domain/api/v1/member/setdetails
- Replace domain with the nats domain
- PATCH
Response Format
- JSON
- HTTP headers
Parameters
Paremeters must be sent with the request body. The examples below show the parameters sent as x-www-form-urlencoded
If you want to remove a field you can pass in the string REMOVE and the field will be removed. All additional parameters have this option other then 'password'. At least one optional parameter must be passed in.
- memberid is used to pass in the memberid of the member to modify
- type: string
- required
- firstname is used to pass in the first name of the member
- type: string
- optional
- lastname is used to pass in the last name of the member
- type: string
- optional
- email is used to pass in the email address of the member
- type: string
- optional
- address1 is used to pass in the address of the member
- type: string
- optional
- address2 is used to pass in the address of the member
- type: string
- optional
- city is used to pass in the city of the member
- type: string
- optional
- state is used to pass in the state of the member
- type: string
- optional
- country is used to pass in the country of the member
- type: string
- optional
- zip is used to pass in the zip code of the member
- type: string
- optional
- custom1 is used to pass in the custom1 field of the member
- type: string
- optional
- custom2 is used to pass in the custom2 field of the member
- type: string
- optional
- custom3 is used to pass in the custom3 field of the member
- type: string
- optional
- custom4 is used to pass in the custom4 field of the member
- type: string
- optional
- custom5 is used to pass in the custom5 field of the member
- type: string
- optional
- password is used to pass in the new password of the member
- type: string
- optional
Example Request
PATCH
http://domain/api/v1/member/setdetails
- Response:
true
Example Code
PHP
<?php
$curl = curl_init();
$data = array(
'memberid' => 191,
'firstname' => 'Test',
'zip' => '66666'
);
$url = 'http://domain/api/member/setdetails';
$headers = array(
'api-key: 44b5498dbcb481a0d00b404c0169af62',
'api-username: tmm1phrvezsbu'
);
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);
?>
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/member/setdetails'
payload = {
'memberid': 191,
'firstname': 'Test',
'zip': '66666'
}
headers = {
'api-key': '44b5498dbcb481a0d00b404c0169af62',
'api-username': 'tmm1phrvezsbu'
}
res = requests.patch(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 = {
'memberid': 191,
'firstname': 'Test',
'zip': '66666'
}
var options = {
url: 'http://domain/api/member/setdetails',
method: 'PATCH',
form: data,
json: true,
headers: {
'api-key': '44b5498dbcb481a0d00b404c0169af62',
'api-username': 'tmm1phrvezsbu'
}
};
function callback(error, response, body) {
if (!error && response.statusCode == 200) {
console.log(body);
}
else{
console.log(body);
}
}
request(options, callback);
Curl
curl -X PATCH 'http://domain/api/member/setdetails' -H "api-key: 44b5498dbcb481a0d00b404c0169af62" -H "api-username: tmm1phrvezsbu" -H "Content-Type: application/x-www-form-urlencoded" -d 'memberid=191&firstname=Test&zip=66666'
