Product Resources

Wednesday, 28 of January 2015

Introduction

The purpose of this section is to describe the Repcamp's Product Resources. Each resource is described through a list fields definition guide and their uses in the Resources request / response actions

 

GET products

Receive a collection of Product Objects.

 

Resource URL

http://api.repcamp.com/v1/products

 

Resource Information

Rate Limited? Yes
Requests per rate limit window: unlimited/user
Authentication: Requires API auth
Response Formats: json
 
HTTP Methods: GET
Resource family: products
Response Object: product
API Version: v1.1

 

Parameters

Parameter Required? Description
skip No Number of objects to be get by the request. Required for a paginated request
https://api.repcamp.com/v1/products?skip=200&take=20
take No Number of objects to be get by the request. Required for a paginated request
https://api.repcamp.com/v1/products?skip=200&take=20

Response

Status 200  - Content body: Array of customers

Status: 401 - Unauthorized

Status: 500 - Error

 

POST products

Add a Product Object .

 

Resource URL

http://api.repcamp.com/v1/products

 

Resource Information

Rate Limited? Yes
Requests per rate limit window: unlimited/user
Authentication: Requires API auth
Response Formats: json
 
HTTP Methods: POST
Resource family: products
Post Object: products
API Version: v1.1

Response

Status 200  Content body: JSON Object that contains the guid of the object inserted: {_id:219918292198919}

Status: 401 - Unauthorized

Status: 500 - Error

 

POST products/bulk

Add a list of products

 

Resource URL

http://api.repcamp.com/v1/products/bulk

 

Resource Information

Rate Limited? Yes
Requests per rate limit window: unlimited/user
Authentication: Requires API auth
Response Formats: json
 
HTTP Methods: POST
Resource family: products
Post Object: product array
API Version: v1.1

Response

Status 200  Content body: JSON Object
 

{Total:Elements sended
inserts: Number of inserts
updates: Number of updates
errors: Number of errors
items_error: array that contains the codes of the error objects. }

 

{
"item_type": "Product",
"total": 2,
"inserts": 2,
"updates": 0,
"errors": 0,
"items_error": [ ]
}

 

Status: 401 - Unauthorized

Status: 500 - Error

 

PUT products/:code

Update a product by code

 

Resource URL

http://api.repcamp.com/v1/products/:code

 

Resource Information

Rate Limited? Yes
Requests per rate limit window: unlimited/user
Authentication: Requires API auth
Response Formats: json
 
HTTP Methods: GET
Resource family: products
Post Object: product
API Version: v1.1

 

Parameters

Parameter Required? Description
code Yes Product Code
https://api.repcamp.com/v1/products/CUS2200
 

Response

Status 200  Content body: JSON Object that contains the guid of the object updated: {_id:219918292198919}

Status: 401 - Unauthorized

Status: 500 - Error

 

DELETE products/:code

Delete a product by code

 

Resource URL

http://api.repcamp.com/v1/products/:code

 

Resource Information

Rate Limited? Yes
Requests per rate limit window: unlimited/user
Authentication: Requires API auth
Response Formats: json
 
HTTP Methods: DELETE
Resource family: products
API Version: v1.1

Parameters

Parameter Required? Description
code Yes Product Code
https://api.repcamp.com/v1/products/CUS2200
 

Response

Status 200  Content body: JSON Object that contains the guid of the object deleted: {_id:219918292198919}

Status: 401 - Unauthorized

Status: 500 - Error