API Documentation

ImagesUpload

Method: /images/upload/[item_id].[format]

This endpoint enables you to remotely upload image files for your inventory items. Images are stored on SalesBinder’s content distribution network.

Max File Size Accepted: 5MB per file
Max Images Per Item: 5 images

Header: Content-Type (required)

You must include the image content-type in the header. Accepted content-types are: ‘image/jpeg’, ‘image/png’, ‘image/gif’.

Syntax:

https://[subdomain].salesbinder.com/api/2.0/images/upload/[item_id].json

HTTP Request Type: POST

Example:

https://demo.salesbinder.com/api/2.0/images/upload/4a21db9c-b547-3e86-9043-c9199deaccef.json

HTTP Request Type: POST

Content-Type: image/jpeg

Success:

If you have been successful in saving a new image, the response will return the newly created data object along with a “success” value of “true” as seen below.

To retrieve the full URL of your newly uploaded images, simply use the Items >> View API endpoint.

Example JSON Returned Response

1{
2    "success": true,
3    "image": {
4        "path_original": "b9d5690e-75f8-4ecd-b7ed-6acc52c5899d.jpg",
5        "path_small": "b9d5690e-75f8-4ecd-b7ed-6acc52c5899d_75x100.jpg",
6        "path_medium": "b9d5690e-75f8-4ecd-b7ed-6acc52c5899d_400x500.jpg",
7        "account_id": "4d76bc2e-b198-4bd6-9555-7439b86a9999",
8        "item_id": "4a21db9c-b547-3e86-9043-c9199deaccef",
9        "original_filename": "1511978249.jpg",
10        "filename": "b9d5690e-75f8-4ecd-b7ed-6acc52c5899d.jpg",
11        "weight": 3,
12        "version": 2,
13        "id": "d582bd14-df9d-4fa1-b27b-a2802387099b"
14    }
15}

Sample Returned XML Data

1<root>
2  <success>true</success>
3  <img>
4    <path_original>b9d5690e-75f8-4ecd-b7ed-6acc52c5899d.jpg</path_original>
5    <path_small>b9d5690e-75f8-4ecd-b7ed-6acc52c5899d_75x100.jpg</path_small>
6    <path_medium>b9d5690e-75f8-4ecd-b7ed-6acc52c5899d_400x500.jpg</path_medium>
7    <account_id>4d76bc2e-b198-4bd6-9555-7439b86a9999</account_id>
8    <item_id>4a21db9c-b547-3e86-9043-c9199deaccef</item_id>
9    <original_filename>1511978249.jpg</original_filename>
10    <filename>b9d5690e-75f8-4ecd-b7ed-6acc52c5899d.jpg</filename>
11    <weight>3</weight>
12    <version>2</version>
13    <id>d582bd14-df9d-4fa1-b27b-a2802387099b</id>
14  
15</root>

Updated on February 4th, 2022