Making Requests
Once authenticated, you can begin making calls to the API. Most API calls require a "retailer context" in the endpoint path -- meaning that most calls require you pass a valid retailer_id that belongs to your Account.
To get a list of retailers available for your account, use the following endpoint:
GET https://api.revcascade.com/v1/retailers/ Authorization: Bearer 0oW0r4m1pjIlb5UJujZA5iVuse0XSn
The id(s) that are returned from that request can be passed into other calls wherever you see the {retailer_id} variable in the API endpoint path, such that...
GET https://api.revcascade.com/v1/retailers/{retailer_id}/orders/
becomes...
GET https://api.revcascade.com/v1/retailers/500/orders/
Including Query String Parameters on GET Requests.
If you want to pass additional filters into a GET request, please pass query string parameters. For example, if you need to filter a list of orders (note that some filter options, like 'status', can be passed more than once):
GET /v1/retailers/500/orders/?status=open&status=closed&is_acknowledged=true Authorization: Bearer 0oW0r4m1pjIlb5UJujZA5iVuse0XSn
Including Input in POSTs, PUTs, or PATCHs
To pass in data to POST, PUT, or PATCH endpoints, make sure to attach Content-type: application/json as a header in the request. The input should then be encoded as JSON.
POST /v1/retailers/500/shipments/ Content-type: application/json Authorization: Bearer 0oW0r4m1pjIlb5UJujZA5iVuse0XSn