API相關工具使用說明
一、API測試工具
API測試工具，資料環境分為：測試（也稱為沙箱環境）、正式（包括應用正式測試環境、上線運行）。測試工具連結
//open.taobao.com/apitools/apiTools.htm
1、 在測試環境下使用API測試工具須注意3點：
1）測試環境下的數據都是模擬線上的測試數據，不能與線上數據混淆。
2）當存取一個存取等級為「須使用者登入"，或須取得存取等級為"隱私資料須使用者登入"的隱私資料時，就需要sessionkey .在測試環境下取得SessionKey，請參閱如何取得sessionkey?。
3）可以自訂App Key，用自己申請的App Key和App Secret來測試。
4）如何取得沙箱環境測試帳號？
【介面預覽】
2、在正式環境下使用API測試工具須注意3點：
1）正式環境下的數據都是真實的數據。
2）用系統預設的App Key測試時，透過點擊「綁定使用者」並用商家帳號登入淘寶網來取得SessionKey，SessionKey有效時間為半小時。如果要換商家測試，那麼再次點選「綁定使用者」重新取得SessionKey即可。綁定成功後，點選「提交測試」。
3）用自訂的App Key和App Secret測試時，在正式環境下取得SessionKey，請參閱如何取得sessionkey?。
【介面預覽】
3、常見問題：
1）參數傳入錯誤。一般是藍色星號的參數沒有傳入。紅色星號的參數為必傳參數。也可能傳入參數格式或類型不對。錯誤排查參考錯誤碼一覽文件、快速檢查問題、錯誤碼排查工具。
2）點選提交測試沒反應。清除快取或換瀏覽器，但少數介面確實需要一定時間才能產生回傳結果，如taobao.trades.sold.get 搜尋目前會話使用者作為賣家已賣出的交易資料。
3）介面呼叫限制只能塔內調用，如何使用測試工具。
在開發者中心後台－聚石塔本地測試增加需要測試的nick，就可以進行塔外IP測試了。
二、API屬性工具
#API屬性工具，它的主要功能是產生商品屬性(props)、銷售屬性(sku_properties)、自訂類別目屬性(input_pids)和自訂屬性值(input_str)。首先，選擇商品類目，然後填寫屬性表單，最後點選「提交」就產生各種屬性串 了。帶*的為商品的必須屬性，產生的屬性字串可作為存取API的參數。屬性工具連結 //open.taobao.com/api_tool/props/
#1、介面預覽
#
2、使用介紹
資料環境可選擇測試和正式，測試表示沙箱環境，正式表示正式環境。商品類目，可用taobao.itemcats.get 取得後台供賣家發布商品的標準商品類目取得。關鍵屬性和銷售屬性以及非關鍵屬性可用taobao.itemprops.get 取得標準商品類別目屬性取得。填選好相關參數點選提交就可以產生相關參數。顯示在右邊產生參數區域。一般用於發布產品和發布商品。
三、錯誤碼排查工具#
#1、工具介紹
則為
#透過API 名稱和錯誤訊息，可以快速定位錯誤原因，從而可以幫助ISV自己快速解決呼叫TOP介面過程中遇到的問題。 存取位址： //open.taobao.com/apitools/errorCodeSearch.htm 。
2、操作步驟
############## ############
輸入API名稱（必填）與錯誤碼（或要求TOP取得完整的錯誤訊息），點選搜尋按鈕，取得到特定的錯誤訊息
# 
3、執行邏輯
1）只輸入API名稱，回傳該API下所有的業務錯誤碼資訊。
2）輸入API名稱和特定的錯誤碼（錯誤body），傳回該API下特定的錯誤碼資訊.
3）如果未搜尋到，提示未找到改變錯誤訊息。 TOP會定期掃描，補充錯誤碼資訊。
#
4、具體#範例
1）只輸入API名稱，傳回該API下所有的業務錯誤碼資訊。
#2）輸入API名稱與特定的錯誤碼（錯誤body ），傳回該API下具體的錯誤碼資訊。
或上# #3）輸入API名稱與錯誤Body，也就是請求top傳回的完整的錯誤訊息，json 或xml格式 # 4）點擊錯誤訊息連結，調到錯誤碼具體解釋頁面 # #：我們將持續的錯誤訊息最佳化 
#FAQ
