Difference between revisions of "XcelData:Terms"

From XcelData Wiki
Jump to: navigation, search
 
Line 25: Line 25:
  
 
A valid drivers license that uniquely identifies the customer.
 
A valid drivers license that uniquely identifies the customer.
 +
 +
== http-request-method ==
 +
'''''enum:''' GET or POST''
 +
 +
This is used at the application layer for directing the kind of request to be made.
 +
 +
Currently we only have apis that consume [[wikipedia:GET_(HTTP)|GET]] and [[wikipedia:POST_(HTTP)|POST]].
 +
 +
'''Examples:'''
 +
<pre>
 +
//get:
 +
curl http://localhost:3000/data1/data2/data3
 +
 +
//post:
 +
curl -d "param1=value1&param2=value2" -X POST http://localhost:3000/data1/data2/data3
 +
 +
//post application/json:
 +
curl -d '{"key1":"value1", "key2":"value2"}' -H "Content-Type: application/json" -X POST http://localhost:3000/data1/data2/data3
 +
 +
//post using a data file:
 +
curl -d "@data.json" -X POST http://localhost:3000/data1/data2/data3
 +
</pre>
 +
 +
== output-format ==
 +
'''''enum:''' json or xml''
 +
 +
Specifies XML or JSON output.
  
 
==service-name==
 
==service-name==
Line 35: Line 62:
  
 
A transaction id that uniquely identifies the customer's transaction.
 
A transaction id that uniquely identifies the customer's transaction.
 
== output-format ==
 
'''''enum:''' json or xml''
 
 
Specifies XML or JSON output.
 
  
 
==unit-type==
 
==unit-type==

Latest revision as of 16:19, 1 May 2018

Terms commonly used in the API

adj-buy

integer or decimal: 0-200

Adjusts the buy amount by n percent.

adj-loan

integer or decimal: 0-200

Adjusts the loan amount by n percent.

adj-sell

integer or decimal: 0-200

Adjusts the sell amount by n percent.

api-key

uuid: 00000000-0000-0000-0000-000000000000

A valid API key. Store API keys can be obtained from app.xceldata.com/customers

drivers-lic

string: a valid drivers lic

A valid drivers license that uniquely identifies the customer.

http-request-method

enum: GET or POST

This is used at the application layer for directing the kind of request to be made.

Currently we only have apis that consume GET and POST.

Examples:

//get:
curl http://localhost:3000/data1/data2/data3

//post:
curl -d "param1=value1&param2=value2" -X POST http://localhost:3000/data1/data2/data3

//post application/json:
curl -d '{"key1":"value1", "key2":"value2"}' -H "Content-Type: application/json" -X POST http://localhost:3000/data1/data2/data3

//post using a data file:
curl -d "@data.json" -X POST http://localhost:3000/data1/data2/data3

output-format

enum: json or xml

Specifies XML or JSON output.

service-name

enum: superpawn or xpawn

Currently used to specify the type of license check to preform.

transaction-id

string: a unique transaction id

A transaction id that uniquely identifies the customer's transaction.

unit-type

enum: dwt or gr

Specifies Pennyweight or Grams (what will be shown to tellers)