PromoProducts.io
JSON API

The PromoProducts.io JSON API makes it easy for developers to integrate PromoStandards-based services into their applications. The API's JSON-based request and response model is a convenient, familiar, and easy to use alternative to SOAP (the communication protocol used by the standards).


Supports All PromoStandards Services

The JSON API supports the following PromoStandards services:


How The JSON API Works

To use the JSON API Service, you send a JSON request, and a JSON response is returned. For example, suppose that you want to get inventory information for a Starline's product AF200. You would send the following JSON payload.

{
  "apiKey": "your-api-key",
  "supplier": "STAR",   
  "id": "your-id",
  "password": "your-password",  
  "service": "INV",
  "version": "1.2.1",  
  "function": "getInventoryLevels",
  "productID": "AF200",
  "productIDType": "Supplier"
}

The JSON-encoded response that you'll get back will look something like this.

{
  "Status": "200",
  "Response": {
    "Envelope": {
      "Body": {
        "Reply": {
          "productID": "AF200",
          "ProductVariationInventoryArray": {
            "ProductVariationInventory": [
              {
                "partID": "AF200-35-00",
                "partDescription": "Tempo Sports Fitness Belt",
                "quantityAvailable": "1500",
                "attributeColor": "Gray",
                "attributeSize": "NA",
                "entryType": "exact",
                "validTimestamp": "2018-07-13T17:47:26.7337365Z"
              },
              {
                "partID": "AF200-36-00",
                "partDescription": "Tempo Sports Fitness Belt",
                "quantityAvailable": "1050",
                "attributeColor": "Red",
                "attributeSize": "NA",
                "entryType": "exact",
                "validTimestamp": "2018-07-13T17:47:26.749361Z"
              }
              ...
            ]
          }
        }
      }
    }
  }
}			

Learn More

Getting Started
API Documentation
FAQ


Get In Touch

If you're interested in testing the API, or if you have any questions, please email Tim Dietrich at timdietrich@me.com.

© Copyright 2018 PromoProducts.io.