API Methods

From Developer's API

Revision as of 19:06, 28 November 2008 by Darrinm (Talk | contribs)

Calling an API method is done by making a request to a method URI

API Methods are of the form https://www.mcssl.com/API/{MerchantId}[/{TableName}[/{ItemId}][/{Command}]]

Contents

Examples

  • https://www.mcssl.com/API/118303
    • Returns a list of Group Level methods available to merchant 118303
  • https://www.mcssl.com/API/118303/Products
    • Returns a list of Product related methods
  • https://www.mcssl.com/API/118303/Products/LIST
    • Returns a list of Products
  • https://www.mcssl.com/API/118303/Products/173457882/READ
    • Returns Product details for ProductId 173457882

Method Documentation

Clients Methods

List Clients
Read Client

Products Methods

List Products
Read Product

Orders Methods

List Orders
Count Orders
Read Order

Errors Methods

API Error Codes

API Parameters

API parameters help to specify what data will be returned from the API. Parameters sent to the API are required to be in XML format as shown below. These parameters can be used in conjunction with one another where the method allows a particular parameter. At the very minimum, your merchant key is required as an API parameter when making API calls.

API Parameter Example

<Request>

   <Key>asfa890sduasdf98...</Key>

   <LimitCount>15</LimitCount>

   <LimitOffset>15</LimitOffset>

</Request>

API Method Parameters Matrix

List Clients List Products List Orders List Errors
Key1
Limit Count2 -
Limit Offset -
Sort Column 3 - 4 -
Sort Order5 - -
Limit Start Date6 - - -
Limit End Date6 - - -
1 Required for every API call
2 Maximum available limit count is 100
3 FirstName, LastName
4 GrandTotal
5 ASC or DESC
6 In the format MM/dd/yyyy [HH:mm:ss]

API Results

The following page show examples of results that can be returned by the API

API_Results