2011年10月4日 星期二

淘寶網API學習心得(二)

從上次寫完「淘寶網API學習心得(一)」到現在已經過了相當的時間,這次要寫的是測試心得,之所以會隔這麼久,是因為測試API需要一組app id和app secret, 而要取得app id和app secret的前提是你的帳號必須做過實名認證,目前我台灣的用戶好像做不了實名認證,所以就只能請公司在大陸申請商家帳號了,由於公司申請淘寶商家帳號花了不少時間,所以直到最近才拿到一組可以讓我測試的商家帳號。

有了實名認證的商家帳號後,就可申請應用程序,有了自已的應用程序就有app id和app secret,詳細申請方法可參考下列網址:
http://dev.open.taobao.com/dev/index.php/Taobao_ID(淘帐号)产品介绍

申請好之後可以從開發者中心登入,登入後選擇「應用管理」->「應用列表


在應用列表頁,可選擇應用程式圖標,名稱,或右側的修改連結進入「開發測試」頁。

在開發測試頁,在預設的情況下是處於「沙箱環境開發」之狀態,在填入表單中的必填欄位後,即可點選下方之「進入正式環境測試」。
沙箱環境和正式環境的差別在於,在沙箱環境所做的任何行為都只是在一個模擬的淘寶網環境,不會影響到正式環境,但有些功能只有在正式環境才比較好測試,如搜尋功能。
正式環境測試是有時間和次數限制的,目前的情況是,每個App只有3次進入正式環境測試的機會,每次可以有5天的時間做測試,所以,如果要進入正式環境,最好還是先做了充份的準備再進去會比較好。
點選左側下方的「配置沙箱環境」連結,可進入配置沙箱環境頁。



如果要在沙箱測試到較完整的功能,建議註冊兩組沙箱測試帳號,「普通帳號」和「商城帳號」各申請一組,並將商城帳號與App綁定。

接下來,我們可以用API在綁定的沙箱商城帳號中上架,但在此之前需先做商城類目授權,也就是說,我們只能在商城中販賣有得到授權的類目的商品。
登入沙箱商城後,點選左側選單的店舖管理->「商城類目授權」。

從「選擇經營類別」選項中選定一個類別,按右側的「搜索」鈕,下方會出現子選項,選定你所要授權的類別後,點選列表下戶的「授權」按鈕。
類目授權完成後,需要等到隔天早上才能生效,之後才能在API中使用你所要使用的類別。


接下來,可以試著用「API測試工具」新增商品。
測試時,記得點選app_key右側的「自定義」按鈕,填入前面申請好的app_key和app_secret。


在上圖表單中,選擇不同的API類目,則API中的選項會跟著改變,而選擇了不同的API,則下方會根據所選的API出現不同的表單。
若要新增商品,可在API類目選擇「商品API」,API選擇「taobao.item.add」,選好後,下方會出現下圖之表單,右側有號的為必填欄位。
當你把游標停在右側的「說明」上方,數秒後可看到該欄位的說明,也可從表單上方的「API详情」連結查看各欄位之詳細說明。
其中要注意的欄位是cid,也就是類目id,此id需使用「API属性工具」查出來。

在「API属性工具」介面中,選擇你在沙箱商城中申請好的類目,則表單右側會出現其所對應之cid。

根據所選的類目的不同,下面幾個欄位的值也會有所不同,如果該欄位有值,則應將各值填到「API測試工具」中所對應的欄位中。

新增商品成功後,可使用查詢API,依照所產生的num_iid來查詢,或到沙箱商城的「商品管理」頁面,亦可找到該商品,也可以用你申請好的買家帳號去登入沙箱商城,購買該商品。