Create media for a product

post

/swm/rs/v1/spaces/{spaceId}/products/{contentId}/media

Uploads a media file for a product content post in a space. File is scanned and stored.

Media file type is limited to the jpg, jpeg, gif, and png formats.

The API user must be a member of the space and have already created (own) the product content post.

Returns the relative SWM-based access URL for the stored media file.

• Request
• Response
• Examples

Request

Supported Media Types

• application/json

Path Parameters

contentId

Type: string

Required: true

The ID of the product post

spaceId

Type: string

Required: true

The ID of the space resource

Body Parameter

{
"file":"string", - Base64 encoded file content
"fileName":"string" - Name of the file
}

Root Schema : /paths/~1swm~1rs~1v1~1spaces~1{spaceId}~1products~1{contentId}~1media/post/parameters/0/schema

Type: string

Response

Supported Media Types

• application/json; charset=UTF-8

200 Response

successful operation

Body

Root Schema : JSONObject

Type: object

201 Response

media resource created

403 Response

not space member

409 Response

media resource already exists

Examples

Sample Request:

       {
        "file":"encrypted_file_contents",
        "fileName":"productImage.jpg"
       }    

Sample Response:

       {"response":{"code":"201.0","developerMessage":"media resource created"},
        "mediaId":"Aex2YHW8qmBHX2gC61PU8VGu",
        "mediaUrl":"/preview/media/product/AMA1iqn08Jz8QGqG/rpCcZTzUdDbVAmRjCy2BFCOO/Aex2YHW8qmBHX2gC61PU8VGu.jpg"}    

Possible Error Codes:

       {
          "code":"404.0","developerMessage":"product resource not found",
          "code":"403.1","developerMessage":"not space member",
          "code":"403.2","developerMessage":"not content creator",
          "code":"409.0","developerMessage":"media resource already exists"
       }