Product Media - ShipStream Developer Center

This API endpoint allows a merchant to manage product media such as images.

Methods

product_media.list
product_media.types
product_media.create
product_media.update
product_media.remove

Entity Properties

Image Type
Image Mime Type
Image Data

`product_media.list`

product_media.list (string $sku) Retrieve list of product images

Parameters

string

Product SKU.

Return Value

An array of objects. Each object will contain Image Data.

Example Request

Get product images by product SKU:

Request

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "method" : "call",
    "params" : [
        "be1c13ed4e03f0ed7f1e4053dfff9658",
        "product_media.list",
        [
            "product2"
        ]
    ]
}

Example Response

Response

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "error" : null,
    "result" : [
        {
            "file" : "/b/l/blackberry8100_2.jpg",
            "position" : 1,
            "exclude" : 0,
            "url" : "http://magentohost/media/catalog/product/b/l/blackberry8100_2.jpg",
            "types" : [
                "image", 
                "thumbnail"
            ]
        }
    ]
}

Error Codes

code	message
100	Requested store view not found.
101	Product not exists.

`product_media.types`

product_media.types (number $setId) Retrieve product image types

Parameters

integer

Attribute set id.

Return Value

An array of objects. Each object will contain Image Type Properties.

Example Request

Request

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "method" : "call",
    "params" : [
        "be1c13ed4e03f0ed7f1e4053dfff9658",
        "product_media.types",
        [
            4        
        ]
    ]
}

Example Response

Response

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "error" : null,
    "result" : [
        {
            "code" : "image",
            "scope" : "store"
        },
        {
            "code" : "thumbnail",
            "scope" : "store"
        }
    ]
}

`product_media.create`

product_media.create (string $sku, object $data) Upload new product image

Parameters

string

Product SKU.

object

Image data.

Return Value

Image file name (e.g., “/i/m/image.png”)

Example Request

Request

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "method" : "call",
    "params" : [
        "be1c13ed4e03f0ed7f1e4053dfff9658",
        "product_media.create",
        [
            "product2",
            {
                "file" : {
                    "content" : "base64 encoded content",
                    "mime": "image/jpeg"
                },
                "position" : 100,
                "types" : [
                    "thumbnail"
                ],
                "exclude" : 0
            }
        ]
    ]
}

Example Response

Response

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "error" : null,
    "result" : [
        "/i/m/image.png"
    ]
}

Error Codes

code	message
100	Requested store view not found.
101	Product not exists.
102	Invalid data given. Details in error message.
104	Image creation failed. Details in error message.
107	Requested product doesn’t support images

`product_media.update`

product_media.update (string $sku, string $file, object $data) Update product image

Parameters

string

Product SKU.

string

Image file name.

object

Image data.

Return Value

true, if the image has been uploaded

Example Request

Request

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "method" : "call",
    "params" : [
        "be1c13ed4e03f0ed7f1e4053dfff9658",
        "product_media.update",
        [
            "product2",
            "/i/m/image.png",
            {
                "file" : {
                    "content" : "base64 encoded content",
                    "mime": "image/jpeg"
                },
                "position" : 100,
                "types" : [
                    "thumbnail"
                ],
                "exclude" : 1
            }
        ]
    ]
}

Example Response

Response

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "error" : null,
    "result" : 1
}

Error Codes

code	message
100	Requested store view not found.
101	Product not exists.
102	Invalid data given. Details in error message.
103	Requested image not exists in product images’ gallery.
104	Image creation failed. Details in error message.
107	Requested product doesn’t support images

`product_media.remove`

product_media.remove (string $sku, string $file) Remove product image

Parameters

string

Product SKU.

string

Image file.

Return Value

true, if the image has been removed

Example Request

Request

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "method" : "call",
    "params" : [
        "be1c13ed4e03f0ed7f1e4053dfff9658",
        "product_media.remove",
        [
            "product2",
            "/b/l/blackberry8100_2.jpg"
        ]
    ]
}

Example Response

Response

{
    "jsonrpc" : 2.0,
    "id" : 1234,
    "error" : null,
    "result" : 1
}

Error Codes

code	message
100	Requested store view not found.
101	Product not exists.
106	Image not removed. Details in error message.
107	Requested product doesn’t support images

Entity Properties

Image Type Properties

Show Image Type Properties

string

A unique identifier for an image type. Allowed: “image”, “thumbnail”.

string

The “Scope” property. Allowed: “global”, “website”, “store”.

Image Mime Type

Show Image Mime Type

string

{ "mime" : "image/jpeg" }

JPEG

string

{ "mime" : "image/gif" }

GIF

string

{ "mime" : "image/png" }

PNG

Image Data

Show Image Data

object | string

Creating a new file:

{ "file" : { "content" : "base64 encoded content", "mime" : "image/jpeg" }}

Retriving existing file:

{ "file" : "/b/l/blackberry8100_2.jpg" }

integer

{ "position" : 3 }

integer

{ "exclude" : 1 }

Allowed: “0” or “1”.

string

{ "url" : "https://shipstream.io/media/catalog/product/b/l/blackberry8100_2.jpg" }

array

{ "types" : ["image", "thumbnail"] }

Allowed: “image”, “thumbnail”.

​Methods

​Entity Properties

​product_media.list

​Parameters

​Return Value

​Example Request

​Example Response

​Error Codes

​product_media.types

​Parameters

​Return Value

​Example Request

​Example Response

​product_media.create

​Parameters

​Return Value

​Example Request

​Example Response

​Error Codes

​product_media.update

​Parameters

​Return Value

​Example Request

​Example Response

​Error Codes

​product_media.remove

​Parameters

​Return Value

​Example Request

​Example Response

​Error Codes

​Entity Properties

​Image Type Properties

​Image Mime Type

​Image Data

Methods

Entity Properties

`product_media.list`

Parameters

Return Value

Example Request

Example Response

Error Codes

`product_media.types`

Parameters

Return Value

Example Request

Example Response

`product_media.create`

Parameters

Return Value

Example Request

Example Response

Error Codes

`product_media.update`

Parameters

Return Value

Example Request

Example Response

Error Codes

`product_media.remove`

Parameters

Return Value

Example Request

Example Response

Error Codes

Entity Properties

Image Type Properties

Image Mime Type

Image Data