---
# System prepended metadata

title: Shopee -  API Call Flows - Upload Item & Model(1)
tags: [flow, API, shopee]

---


# Shopee -  API Call Flows - Upload Item & Model(1)

---

[圖片來源](https://open.shopee.com/documents?module=87&type=2&id=60&version=2) 
[高解析度圖片點我](https://open.shopee.com/api/v1/image/download/?image_type=png&image_id=RarzzgBCHFJveusQOuAm%2BD64FQJCterEETQLBifplE5UO4oX7Vx6GNDubmuCRrNxV96c%2FctTH18dFj5f1gS9Ag%3D%3D)

> Upload Item & Model 分為兩篇
> 
> Shopee - OpenvPlatform API Call Flows - Upload Item & Model(1)
> <font color="#f00">針對 Add item flow</font>
> 
> Shopee - OpenvPlatform API Call Flows - Upload Item & Model(2)
> <font color="#f00">針對 Add Model</font>

**> 因為flow較長，所以切成三個區塊說明**

第一區塊
---
![](https://i.imgur.com/h6JV8qM.png)

Flow 簡易說明
 
<font color="#f00">Start</font>
 ↓
<font color="#f00">media_space.upload_image</font> (上圖第一個主流程點)
說明：使用這個 API 把你的圖片檔案，轉換成蝦皮圖片用的 <font color="#f00">Image Id</font>
　　　這個 <font color="#f00">Image Id</font> 將會被用在與產品上傳相關的API 

---

選擇性 Flow (上圖右方虛線流程，有影片需要上傳，才會走這條)

說明：影片時間介於10秒~60秒，大小30MB之內
　　　如果影片超過4MB，會切成好幾段小於等於4MB
　　　在呼叫get_video_upload_result API之後，回傳的status是success的話，
　　　這個 <font color="#f00">upload_id</font> 就可以被使用，在產品上傳相關的API 
 
<font color="#f00">media_space.int_video_upload</font> 開始影片上傳
 ↓
<font color="#f00">media_space.upload_video_part</font> 上傳分割的影片
 ↓
<font color="#f00">media_space.complete_video</font> 完成影片上傳
 ↓
<font color="#f00">media_space.get_video_upload_result</font> 取得影片上傳結果

[Open API_v2功能清單簡述](https://seller.shopee.tw/edu/article/7632/v2-APIs)

---
繼續主流程
↓
<font color="#f00">product.get_category</font>(上圖第二個主流程點)
說明：選擇一個類別並解選擇一個適合的 <font color="#f00">category_id</font> 到下一個 API
　　　這個屬性是被選來的，所以如果<font color="#f00">category_id</font> 沒有 cheildren，
　　　請在最後的節點使用 <font color="#f00">has_children = false</font>
↓
<font color="#f00">product.get_brand_list</font>(上圖第三個主流程點)
說明：使用這個API，取得一個適合品牌的種類
　　　這個 <font color="#f00">brand_id</font> 可以被使用在可以被使用，在產品上傳相關的API
↓

---
第二區塊
---
![](https://i.imgur.com/si2aBCD.png)
延續上面流程
↓
<font color="#f00">product.get_dts_limit</font>(上圖第一個主流程點)
說明:使用這個API可以取得days_to_ship (發貨天數) 限制
　　 不同的類別，有不同的限制，參數名稱就是＂days_to_ship＂
　　 如果開發人員通過API 取得 min_limit=max_limit = -1
　　 這個意思就是代表不能預定
↓
     
---
> What is Days to Ship (DTS)?
> 
> Days to Ship (DTS) is the estimated number of days it takes for an order to be prepared for shipment and arranged for pickup. The setting of DTS per listing would depend on product availability. On-hand item(s) should be shipped out within 2 days.
> 
> Note:
> 
> Sundays are not included in the Days To Ship count.
> DTS will be extended if the 2 days will fall on a Sunday.
> If your DTS falls on a Sunday, it will be scheduled for next day pickup.

↓
<font color="#f00">product.get_attributes</font>(上圖第二個主流程點)
說明：使用這個API取得一些必要以及非必要的屬性,以及某個類別的屬性值
　　　如果是回傳是 <font color="#f00">parent_attribute_list</font> or <font color="#f00">parent_brand_list</font>
　　　指的是這個屬性擁有父子結構，如果子屬性包含父屬性/產品時,
　　　當開發人員使用這個產品相關的API時，需要同時上傳父屬性/產品和子屬性
↓
<font color="#f00">product.get_cannel_list</font>(上圖第三個主流程點)
說明：這裡沒特別說明，意思應該就如字面上，取得渠道清單


---
第三區塊
---
![](https://i.imgur.com/nF7Qqhz.png)

延續上面流程
↓
<font color="#f00">product.support_size_chart</font>(上圖第一個主流程點)
說明：使用這個API來確認該分類是否支持尺碼表上傳
　　　如果支援就使用 product.upload_size_chart API　來上傳
↓
<font color="#f00">product.add_item</font>(上圖第二個主流程點)
說明：從上面這些流程,獲得相對應的資訊之後
　　　使用這個API上傳沒有模型的產品，如果成功, 系統將會產生<font color="#f00">item_id</font> 並且return 回去．
   
   以上是蝦皮　Add Item 的流程．

###### tags: `shopee` `API` `flow`

