Difference between revisions of "NATS5 REST API Program PATCH default payout"
From TMM Wiki
Jump to navigationJump to searchLine 73: | Line 73: | ||
** optional | ** optional | ||
+ | == '''Example Request''' == | ||
+ | Method: '''PATCH'''<br/> | ||
+ | URL: <nowiki>http://domain/api/program/default_payout</nowiki><br/> | ||
+ | Form Data:<br/> | ||
+ | * programid: 1 | ||
+ | * field_0: 5 | ||
+ | * field_1: 5 | ||
+ | * field_2: 5 | ||
+ | * field_3: 5 | ||
+ | * field_4: 10 | ||
+ | * field_5: 5 | ||
+ | * field_6: 2 | ||
+ | * field_7: 1 | ||
+ | |||
+ | Response: | ||
+ | <pre> | ||
+ | { | ||
+ | "success": true, | ||
+ | "result": "Default payout updated", | ||
+ | "payouts": [ | ||
+ | { | ||
+ | "id": 0, | ||
+ | "field": "Raw", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "5.00", | ||
+ | "max": "5.00", | ||
+ | "min": "5.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 1, | ||
+ | "field": "Unq", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "5.00", | ||
+ | "max": "5.00", | ||
+ | "min": "5.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 2, | ||
+ | "field": "Qual", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "5.00", | ||
+ | "max": "5.00", | ||
+ | "min": "5.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 3, | ||
+ | "field": "$ Join", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "5.00", | ||
+ | "max": "5.00", | ||
+ | "min": "5.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 4, | ||
+ | "field": "$ Rebill", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "10.00", | ||
+ | "max": "10.00", | ||
+ | "min": "10.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 5, | ||
+ | "field": "$ Active", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "5.00", | ||
+ | "max": "5.00", | ||
+ | "min": "5.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 6, | ||
+ | "field": "% Join", | ||
+ | "pre": "", | ||
+ | "post": "%", | ||
+ | "value": "2.00", | ||
+ | "max": "2.00", | ||
+ | "min": "2.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 7, | ||
+ | "field": "% Rebill", | ||
+ | "pre": "", | ||
+ | "post": "%", | ||
+ | "value": "1.00", | ||
+ | "max": "1.00", | ||
+ | "min": "1.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 8, | ||
+ | "field": "% Dialer", | ||
+ | "pre": "", | ||
+ | "post": "%", | ||
+ | "value": "0.00", | ||
+ | "max": "0.00", | ||
+ | "min": "0.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 9, | ||
+ | "field": "NCR", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "0.00", | ||
+ | "max": "0.00", | ||
+ | "min": "0.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 10, | ||
+ | "field": "Third Reg", | ||
+ | "pre": "$", | ||
+ | "post": "", | ||
+ | "value": "0.00", | ||
+ | "max": "0.00", | ||
+ | "min": "0.00", | ||
+ | "default": "0.00" | ||
+ | }, | ||
+ | { | ||
+ | "id": 11, | ||
+ | "field": "% Active", | ||
+ | "pre": "", | ||
+ | "post": "%", | ||
+ | "value": "0.00", | ||
+ | "max": "0.00", | ||
+ | "min": "0.00", | ||
+ | "default": "0.00" | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | |||
== '''Example Code''' == | == '''Example Code''' == | ||
Line 86: | Line 232: | ||
$url = 'http://yourdomain.com'; //set your NATS URL here | $url = 'http://yourdomain.com'; //set your NATS URL here | ||
− | $data = | + | $data = Array( |
− | + | 'programid' => 1, | |
+ | 'field_0' => 5, | ||
+ | 'field_1' => 5, | ||
+ | 'field_2' => 5, | ||
+ | 'field_3' => 5, | ||
+ | 'field_4' => 10, | ||
+ | 'field_5' => 5, | ||
+ | 'field_6' => 2, | ||
+ | 'field_7' => 1, | ||
); | ); | ||
Line 132: | Line 286: | ||
[[Category:NATS4_REST_program_Collection]] | [[Category:NATS4_REST_program_Collection]] | ||
[[Category:Autogenerated_Wiki_Article]]<!-- Remove this tag when customizing a wiki article. The article will no longer be automatically updated --> | [[Category:Autogenerated_Wiki_Article]]<!-- Remove this tag when customizing a wiki article. The article will no longer be automatically updated --> | ||
− | [[Category: | + | [[Category:Autogenerated_Rest_Sample]]<!-- This article has a generated REST API Sample from our unit testing system. Also remove if customizing the wiki article --> |
Revision as of 11:09, 8 July 2019
PATCH /program/default_payout
Description
- Edit default payout for program
Resource URL
- http://domain/api/program/default_payout
- Replace domain with the nats domain
- PATCH
Response Format
- JSON
- HTTP headers
Parameters
Parameters can be sent as url encoded params
- programid
- type: digit
- required
- field_0
- type: numeric
- optional
- field_1
- type: numeric
- optional
- field_2
- type: numeric
- optional
- field_3
- type: numeric
- optional
- field_4
- type: numeric
- optional
- field_5
- type: numeric
- optional
- field_6
- type: numeric
- optional
- field_7
- type: numeric
- optional
- field_8
- type: numeric
- optional
- field_9
- type: numeric
- optional
- field_10
- type: numeric
- optional
- field_11
- type: numeric
- optional
- field_12
- type: numeric
- optional
- field_13
- type: numeric
- optional
- field_14
- type: numeric
- optional
- field_15
- type: numeric
- optional
Example Request
Method: PATCH
URL: http://domain/api/program/default_payout
Form Data:
- programid: 1
- field_0: 5
- field_1: 5
- field_2: 5
- field_3: 5
- field_4: 10
- field_5: 5
- field_6: 2
- field_7: 1
Response:
{ "success": true, "result": "Default payout updated", "payouts": [ { "id": 0, "field": "Raw", "pre": "$", "post": "", "value": "5.00", "max": "5.00", "min": "5.00", "default": "0.00" }, { "id": 1, "field": "Unq", "pre": "$", "post": "", "value": "5.00", "max": "5.00", "min": "5.00", "default": "0.00" }, { "id": 2, "field": "Qual", "pre": "$", "post": "", "value": "5.00", "max": "5.00", "min": "5.00", "default": "0.00" }, { "id": 3, "field": "$ Join", "pre": "$", "post": "", "value": "5.00", "max": "5.00", "min": "5.00", "default": "0.00" }, { "id": 4, "field": "$ Rebill", "pre": "$", "post": "", "value": "10.00", "max": "10.00", "min": "10.00", "default": "0.00" }, { "id": 5, "field": "$ Active", "pre": "$", "post": "", "value": "5.00", "max": "5.00", "min": "5.00", "default": "0.00" }, { "id": 6, "field": "% Join", "pre": "", "post": "%", "value": "2.00", "max": "2.00", "min": "2.00", "default": "0.00" }, { "id": 7, "field": "% Rebill", "pre": "", "post": "%", "value": "1.00", "max": "1.00", "min": "1.00", "default": "0.00" }, { "id": 8, "field": "% Dialer", "pre": "", "post": "%", "value": "0.00", "max": "0.00", "min": "0.00", "default": "0.00" }, { "id": 9, "field": "NCR", "pre": "$", "post": "", "value": "0.00", "max": "0.00", "min": "0.00", "default": "0.00" }, { "id": 10, "field": "Third Reg", "pre": "$", "post": "", "value": "0.00", "max": "0.00", "min": "0.00", "default": "0.00" }, { "id": 11, "field": "% Active", "pre": "", "post": "%", "value": "0.00", "max": "0.00", "min": "0.00", "default": "0.00" } ] }
Example Code
PHP
<?php $headers = array( //set your username and API key here 'api-key: 44b5498dbcb481a0d00b404c0169af62', 'api-username: tmm1phrvezsbu' ); $url = 'http://yourdomain.com'; //set your NATS URL here $data = Array( 'programid' => 1, 'field_0' => 5, 'field_1' => 5, 'field_2' => 5, 'field_3' => 5, 'field_4' => 10, 'field_5' => 5, 'field_6' => 2, 'field_7' => 1, ); $request = Array( 'method' => 'PATCH', 'path' => 'v1/program/default_payout', 'data' => $data ); /*code below is the same for (almost) every API call */ $curl = curl_init(); $url = $url.'/api/'.$request['path']; $query = http_build_query($request['data']); if($request['method'] == 'GET'){ //add query string parameters to the end of the url $url = $url.'?'.$query; }else{ //send parameters as POST fields curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $query); if($request['method'] != 'POST'){ $headers[] ='X-HTTP-Method: '.$request['method']; //send custom request method } } curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $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); ?>