Add Product Images
只可上傳10MB以下的JPEG或PNG格式圖片
Can only upload JPEG or PNG with maximum 10MB.
Breaking Changes
Jul. 30, 2025 拿取商品相關資訊 API 異動公告 Products related API Breaking Change
Function
Add or replace product images to an existing product.
透過open API對現有商品進行新增或覆蓋圖片。
URL
POST <<api_domain>>/v1/products/:id/add_images
Request Parameters
| Parameter | Value | Description | Example |
|---|---|---|---|
| id *Required | String | Product ID 欲新增圖片之商品ID | 5d3594c276e7ec003b7021c0 |
| urls | Array | Urls of the Images 新增圖片之url - _Supports multiple urls 支援多個url在陣列中_Limitation:數量限制 Main Pictures 主商品圖片 - 12 Detail Pictures 更多商品圖片 - 20 | ruby "urls":["http://i.imgur.com/4CV6QpV.jpg"] |
| image_type | String | Image Type 圖片種類 - _main - 主商品圖片_detail - 更多商品圖片 *Default: main | ruby "image_type": "main" "image_type": "detail" |
| is_replcae | Boolean | Whether replacing the original images 是否取代原本數量 - *Default: false | ruby "is_replace": true "is_replace": false |
Request Example
{
"urls": ["http://i.imgur.com/4CV6QpV.jpg","http://i.imgur.com/4CV6QpV.jpg"],
"image_type": "main",
"is_replcae": true
}
Response Example
Same with Get Product
{
"id": "5d3594c276e7ec003b7021c0",
"status": "active",
"title_translations": {
"en": "testing SL-8049",
"zh-hant": "測試 SL-8049 round 2"
},
"price": {
"cents": 3444,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$3,444",
"dollars": 3444
},
"price_sale": {
"cents": 689,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$689",
"dollars": 689
},
"lowest_price": {
"cents": 689,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$689",
"dollars": 689
},
"hide_price": false,
"same_price": true,
"cost": {
"cents": 609,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$609",
"dollars": 609
},
"member_price": {
"cents": 500,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$500",
"dollars": 500
},
"is_preorder": false,
"preorder_note_translations": {
"en": "Shipping starts April 20th, 1971, preorder NOW!",
"zh-hant": "1971/04/20 開始出貨, 立即訂購!"
},
"weight": 123.99,
"quantity": 87,
"unlimited_quantity": false,
"medias": [
{
"images": {
"original": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/original.jpg?1564980407"
},
"source": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/source.jpg?1564980407"
},
"thumb": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/thumb.jpg?1564980407"
},
"large": {
"width": 500,
"height": 500,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/large.jpg?1564980407"
},
"xlarge": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/xlarge.jpg?1564980407"
},
"favicon_small": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/thumb.jpg?1564980407"
},
"favicon": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/thumb.jpg?1564980407"
},
"favicon_large": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/thumb.jpg?1564980407"
},
"transparent_thumb": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/thumb.jpg?1564980407"
},
"transparent_large": {
"width": 500,
"height": 500,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/large.jpg?1564980407"
},
"transparent_xlarge": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4b8c9922900234d5527/xlarge.jpg?1564980407"
}
},
"_id": "5d47b4b8c9922900234d5527",
"alt_translations": {}
},
{
"images": {
"original": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/original.jpg?1564980409"
},
"source": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/source.jpg?1564980409"
},
"thumb": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/thumb.jpg?1564980409"
},
"large": {
"width": 500,
"height": 500,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/large.jpg?1564980409"
},
"xlarge": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/xlarge.jpg?1564980409"
},
"favicon_small": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/thumb.jpg?1564980409"
},
"favicon": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/thumb.jpg?1564980409"
},
"favicon_large": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/thumb.jpg?1564980409"
},
"transparent_thumb": {
"width": 200,
"height": 200,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/thumb.jpg?1564980409"
},
"transparent_large": {
"width": 500,
"height": 500,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/large.jpg?1564980409"
},
"transparent_xlarge": {
"width": 580,
"height": 580,
"url": "https://img.shoplineapp.com/media/image_clips/5d47b4ba82c2a9001d56fd81/xlarge.jpg?1564980409"
}
},
"_id": "5d47b4ba82c2a9001d56fd81",
"alt_translations": {}
}
],
"detail_medias": [],
"category_ids": [
"5be90603d1270b4032bed8b4"
],
"sku": "sku_123345",
"barcode": null,
"field_titles": [
{
"key": "custom",
"label": "Custom",
"name_translations": {
"en": "custom1 en",
"zh-hant": "自訂 中文"
}
},
{
"key": "custom",
"label": "Custom",
"name_translations": {
"en": "Custom",
"zh-hant": "自訂"
}
}
],
"variations": [
{
"id": "5d3594c2e95d2f000642e011",
"fields_translations": {
"en": [
"green",
"L1"
],
"zh-hant": [
"綠",
"大1"
]
},
"price": {
"cents": 999999999,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$999,999,999",
"dollars": 999999999
},
"price_sale": {
"cents": 689,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$689",
"dollars": 689
},
"member_price": {
"cents": 899,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$899",
"dollars": 899
},
"quantity": 100,
"unlimited_quantity": null,
"media": {},
"sku": "green_l1",
"location_id": "LaB123",
"variant_option_ids": [
"5d3594c2622a56618082c99f",
"5d3594c2622a56618082c9a0"
],
"barcode": null
},
{
"id": "5d3594c2e95d2f000642e012",
"fields_translations": {
"en": [
"green",
"S1"
],
"zh-hant": [
"綠",
"小1"
]
},
"price": {
"cents": 999999999,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$999,999,999",
"dollars": 999999999
},
"price_sale": {
"cents": 689,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$689",
"dollars": 689
},
"member_price": {
"cents": 0,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "",
"dollars": 0
},
"quantity": 10,
"unlimited_quantity": null,
"media": {},
"sku": "green_s1",
"location_id": null,
"variant_option_ids": [
"5d3594c2622a56618082c99f",
"5d3594c2622a56618082c9a1"
],
"barcode": null
},
{
"id": "5d3594c2e95d2f000642e013",
"fields_translations": {
"en": [
"Red",
"L1"
],
"zh-hant": [
"紅",
"大1"
]
},
"price": {
"cents": 999999999,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$999,999,999",
"dollars": 999999999
},
"price_sale": {
"cents": 689,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$689",
"dollars": 689
},
"member_price": {
"cents": 0,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "",
"dollars": 0
},
"quantity": 10,
"unlimited_quantity": null,
"media": {},
"sku": "red_l1",
"location_id": null,
"variant_option_ids": [
"5d3594c2622a56618082c9a2",
"5d3594c2622a56618082c9a0"
],
"barcode": null
},
{
"id": "5d3594c2e95d2f000642e014",
"fields_translations": {
"en": [
"Red",
"S1"
],
"zh-hant": [
"紅",
"小1"
]
},
"price": {
"cents": 0,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "",
"dollars": 0
},
"price_sale": {
"cents": 689,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$689",
"dollars": 689
},
"member_price": {
"cents": 0,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "",
"dollars": 0
},
"quantity": 10,
"unlimited_quantity": null,
"media": {},
"sku": "red_s1",
"location_id": null,
"variant_option_ids": [
"5d3594c2622a56618082c9a2",
"5d3594c2622a56618082c9a1"
],
"barcode": null
}
],
"variant_options": [
{
"id": "5d3594c2622a56618082c99f",
"name_translations": {
"en": "green",
"zh-hant": "綠"
},
"type": "custom",
"media": {},
"index": 0
},
{
"id": "5d3594c2622a56618082c9a0",
"name_translations": {
"en": "L1",
"zh-hant": "大1"
},
"type": "custom",
"media": {},
"index": 1
},
{
"id": "5d3594c2622a56618082c9a1",
"name_translations": {
"en": "S1",
"zh-hant": "小1"
},
"type": "custom",
"media": {},
"index": 1
},
{
"id": "5d3594c2622a56618082c9a2",
"name_translations": {
"en": "Red",
"zh-hant": "紅"
},
"type": "custom",
"media": {},
"index": 0
}
],
"categories": [
{
"id": "5be90603d1270b4032bed8b4",
"name_translations": {
"en": "Featured Products",
"zh-hant": "精選商品"
},
"seo_title_translations": {},
"seo_description_translations": {},
"seo_keywords": null,
"key": "featured_products",
"status": "active",
"banner_medias": [],
"parent_id": null,
"priority": 1,
"children": [
{
"id": "5c8a1722b3c511002051da64",
"name_translations": {
"en": "測試prod",
"zh-hant": "測試prod"
},
"seo_title_translations": {
"en": "22222",
"zh-hant": "SEO優化 change"
},
"seo_description_translations": {
"en": "SEO description11",
"zh-hant": "SEO 內文2"
},
"seo_keywords": "關鍵字修改222",
"key": null,
"status": "active",
"banner_medias": [],
"parent_id": "5be90603d1270b4032bed8b4",
"priority": 2,
"children": [
{
"id": "5c8a184190207b003e650034",
"name_translations": {
"en": "測試2"
},
"seo_title_translations": {
"en": "Seasonal sale",
"zh-hant": "測試"
},
"seo_description_translations": {
"en": "Winter clothes- inventory clearance of clothes, shoes, boots, purses and other seasonal items.",
"zh-hant": "冬季清倉特賣"
},
"seo_keywords": "特賣, 冬季",
"key": null,
"status": "active",
"banner_medias": [],
"parent_id": "5c8a1722b3c511002051da64",
"priority": 3
}
]
}
]
}
],
"location_id": "shoplineabc",
"description_translations": {
"en": "No transaction fees. No design or technical skills required. Integrated with multiple payment and logistic options. With over 120,000 merchants online. Everything you need for your e-commerce store.",
"zh-hant": "我們是一家以產品設計為主導的公司， 旨在打造款式簡潔時尚且關注社會大眾需求的產品。 公司聚集了一批來自哈佛大學設計學院 以及麻省理工商學院的優秀設計團隊。 我們致力於設計獨特新穎的創新產品， 適合不同年齡，性別人士使用。 在執著追求產品優化同時，注重履行企業社會責任。"
},
"seo_title_translations": {
"en": "SHOPLINE",
"zh-hant": "商線科技"
},
"seo_description_translations": {
"en": "No transaction fees. No design or technical skills required. Integrated with multiple payment and logistic options. With over 120,000 merchants online. Everything you need for your e-commerce store.",
"zh-hant": "我們是一家以產品設計為主導的公司， 旨在打造款式簡潔時尚且關注社會大眾需求的產品。 公司聚集了一批來自哈佛大學設計學院 以及麻省理工商學院的優秀設計團隊。 我們致力於設計獨特新穎的創新產品， 適合不同年齡，性別人士使用。 在執著追求產品優化同時，注重履行企業社會責任。"
},
"seo_keywords": "電商, 開店, 創業",
"is_reminder_active": true,
"show_custom_related_products": false,
"related_product_ids": [
"5d3593cd5722660032e8fbed",
"5d355b7b0e5da9001741ac2c",
"5d2fec200c3806061516b222",
"5cfe2ff0b92d2000327495c5"
],
"tags": [
"shopline",
"123",
"abc"
],
"blacklisted_delivery_option_ids": [],
"blacklisted_payment_ids": [],
"max_order_quantity": 4,
"out_of_stock_orderable": false,
"subscription_enabled": false,
"subscription_period_duration": 30,
"filter_tags": []
}
Updated about 2 months ago