Difference between revisions of "NATS4 REST API Expire Manual Member"
From TMM Wiki
Jump to navigationJump to search| Line 4: | Line 4: | ||
== '''PUT /member/expiremanual''' == | == '''PUT /member/expiremanual''' == | ||
'''Description''' | '''Description''' | ||
| − | *The /member/expiremanual | + | *The /member/expiremanual action allows you to expire manual members. This lets you mark your Manually created members as expired in [[NATS]] through an automated process by running code that calls the expire manual member API. This function will need to send all relevant data for a manual member so NATS can expire the manual member as you would through the NATS admin. |
'''Resource URL''' | '''Resource URL''' | ||
Revision as of 01:48, 18 March 2015
PUT /member/expiremanual
Description
- The /member/expiremanual action allows you to expire manual members. This lets you mark your Manually created members as expired in NATS through an automated process by running code that calls the expire manual member API. This function will need to send all relevant data for a manual member so NATS can expire the manual member as you would through the NATS admin.
Resource URL
- http://domain/api/v1/member/expiremanual
- Replace domain with the nats domain
- PUT
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 a memberid is entered, the member with this id will expire. Otherwise a username/site id must be supplied
- memberid: The Memberid to be expired
- type: int
- optional
- username: The username of the member who should expire
- type: string
- optional
- siteid: The site id the member belongs to
- type: int
- optional
Example Request
PUT
http://domain/api/v1/member/expiremanual
- Response:
"Expired member: 162"
Example Code
PHP
<?php
$curl = curl_init();
$data = array(
'memberid' => '162',
);
$url = 'http://domain/api/member/expiremanual';
$headers = array(
'api_key: 44b5498dbcb481a0d00b404c0169af62',
'api_username: tmm1phrvezsbu'
);
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "PUT");
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/expiremanual'
payload = {
'memberid': '162',
}
headers = {
'api_key': '44b5498dbcb481a0d00b404c0169af62',
'api_username': 'tmm1phrvezsbu'
}
res = requests.put(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': '162',
}
var options = {
url: 'http://domain/api/member/expiremanual',
method: 'PUT',
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 PUT 'http://domain/api/member/expiremanual' -H "api_key: 44b5498dbcb481a0d00b404c0169af62" -H "api_username: tmm1phrvezsbu" -H "Content-Type: application/x-www-form-urlencoded" -d 'memberid=162'
