Product Images API

General Information

 All pictures are available in the following repositories:

  • High Definition : https://api.stanleystella.com/Pictures

  • Low Defition : https://api.stanleystella.com/Pictures-LD

We recommend you to take local copies of our pictures and not to link directly to our server. If you do, you may experience performance issues.

You can retrieve the list of all pictures in two ways:

  • CSV file

    • Download a CSV file containing the list of pictures and their attributes (f.ex URL, name, type, etc).

  • JSON/REST web service

    • This web service lets you download the list of pictures and their attributes. You can either download the whole list or filter the pictures using several criteria's (f.ex style code, color code, etc).


CSV File

You can retrieve the list of pictures by downloading a CSV file.

In order to use this system, valid credentials are required. If you do not have one yet, please request an account.

Request an account


Download our pictures list as a CSV file.

Quick Access (logged users)

Important:

Once logged in you will see a screen letting you download the Products CSV. In order to find the screen to download the Product Images CSV you first need to press the "Cancel" button. In the menu on the top bar, open the menu "Stanley Data" and choose "Export Product Images (csv)".


You will then see the following screen.


Just click "Download images products CSV" to download all the pictures data.

Alternatively, you can fill in some filters before downloading the CSV. You will then receive a CSV file containing only the result of your request.


JSON/REST

Stanley/Stella Product Images API is JSON/RPC webservice that lets you call our images database, and import this data in your own system. The information is provided real time and contains all details about all images.

The Data is provided through one endpoint:

  • products_images : a full list of all packshots you can use in your website, with URL to the resource and detailed information about the photo.


Please also note

  • Method to be used is POST

  • Encoding is UTF-8

  • Text delimiter is the quote (")

  • Field delimiter is the semicolon (;)

  • The API must be called with the https prefix

In order to use this system, valid credentials are required. If you do not have one yet, please request an account request an account.

Request an account

If you wish to test your code, you can do so with a tool like Postman.

Integration

Endpoint Settings

Environment
Server
Database
TEST
https://apitest.stanleystella.com
mig_api
PROD
https://api.stanleystella.com
production_api

Note : the test endpoint is deemed to be used with eligible partners when we develop new features with our API. You should connect to our prod environment.

Get JSON

Service
URL
Pictures
/webrequest/products_images/get_json


Parameters for "Products_images"

Parameter
Type
Sample Value
Comment
db_name
mandatory
production_api

user
mandatory
your login

password
mandatory
your password

StyleCode
optional
STTM528

ColorCode
optional
C001


Examples of call
See the Products API page for examples of JSON/REST API calls. The Product Images API works in a very similar way.

Retrieving the data

{
    "jsonrpc": "2.0",
    "id": null,
    "result":
     "[
      {
       \"Type\": \"Default\",
       \"Category\": \"Default\",
       \"Gender\": \"Not Applicable\",
       \"StyleCode\": \"STTM522\",
       \"ColorCode\": \"C702\",
       \"PhotoTypeCode\": \"Packshot\",
       \"PhotoShootCode\": \"Side\",
       \"PhotoSequenceCode\": 0,
       \"StyleName\": \"STTM522\",
       \"FName\": \"PSM0_STTM522_C702.jpg\",
       \"Color\": \"Stargazer\",
       \"FTPFilePath\": \"\",
       \"FTPZipPath\": \"\",
       \"HTMLPath\": \"http://api.stanleystella.com:8080/Pictures/PSM0_STTM522_C702.jpg\"
      },
      {
       \"Type\": \"Default\",
       \"Category\": \"Default\",
       \"Gender\": \"Not Applicable\",
       \"StyleCode\": \"STTM522\",
       \"ColorCode\": \"C677\",
       \"PhotoTypeCode\": \"Packshot\",
       \"PhotoShootCode\": \"Side\",
       \"PhotoSequenceCode\": 0,
       \"StyleName\": \"STTM522\",
       \"FName\": \"PSM0_STTM522_C677.jpg\",
       \"Color\": \"Slub Mid Heather Clay\",
       \"FTPFilePath\": \"\",
       \"FTPZipPath\": \"\",
       \"HTMLPath\": \"http://api.stanleystella.com:8080/Pictures/PSM0_STTM522_C677.jpg\"
      }
     ]"
}

The webservice response is a JSON/RPC response with a result key containing all requested objects - provide the error key does not exist.

If you wish to reuse the data, you must use the JSON.parse(response.result) method. This will return a table containing all objects.