NATS4 REST API Decode Natscode
From TMM Wiki
Jump to navigationJump to searchThe printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
GET /service/decodenatscode
Description
- NATS4 supports an API resource to decode a natscode sent to the decodenatscode endpoint
Resource URL
- http://domain/api/codes/decode
- Replace domain with your nats domain
- GET
Response Format
- JSON
- HTTP headers
Parameters
Paremeters can be sent as url encoded params.
- natscode: The natscode you would like to decode.
- type: string
- required
Example Request
GET
http://domain/api/service/decodenatscode
- Response:
{ "loginid": "1", "programid": "2", "siteid": "2", "tourid": "2", "campaignid": "0", "adtoolid": "0", "subid1": "0", "subid2": "0", "promotionalid": "0", "is_unencoded": 0, "old_code": 0, "inhouse": "0", "username": "tmm1phrvezsbu" }
Example Code
PHP
<?php $curl = curl_init(); $data = array( 'natscode' => 'MS4yLjIuMi4wLjAuMC4wLjA' ); $data_string = http_build_query($data); $url = 'http://domain/api/service/decodenatscode?'.$data_string; $headers = array( 'api-key: 44b5498dbcb481a0d00b404c0169af62', 'api-username: tmm1phrvezsbu' ); curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_URL, $url); $resp = curl_exec($curl); //dumps an associative array representation of the json $output = json_decode($resp,TRUE); if ($output === NULL) { print_r($resp); } else { var_dump($output); } // 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 url = 'http://domain/api/service/decodenatscode' params = { 'natscode': 'MS4yLjIuMi4wLjAuMC4wLjA' } headers = { 'api-key': '44b5498dbcb481a0d00b404c0169af62', 'api-username': 'tmm1phrvezsbu' } res = requests.get(url, params=params, 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'); var options = { url: 'http://domain/api/service/decodenatscode', method: 'GET', qs: { 'natscode': 'MS4yLjIuMi4wLjAuMC4wLjA' }, 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 GET 'http://domain/api/service/decodenatscode?natscode=MS4yLjIuMi4wLjAuMC4wLjA' -H "api-key: 44b5498dbcb481a0d00b404c0169af62" -H "api-username: tmm1phrvezsbu"
Legacy Changes
Use the following documentation changes if you are using the REST API with NATS versions below 4.1.13.5:
Resource URL
- http://domain/api/decodenatscode
- Replace domain with your nats domain
Parameters - Paremeters can be sent as url encoded params.
- data: The natscode you would like to decode.
- type: string
- optional