API相關(guān)工具使用說明
一、API測試工具
API測試工具，數(shù)據(jù)環(huán)境分為：測試（也稱沙箱環(huán)境）、正式（包括應用正式測試環(huán)境、上線運行）。測試工具鏈接
//open.taobao.com/apitools/apiTools.htm
1、 在測試環(huán)境下使用API測試工具須注意3點：
1）測試環(huán)境下的數(shù)據(jù)都是模擬線上的測試數(shù)據(jù)，不能與線上數(shù)據(jù)混淆。
2）當訪問一個訪問級別為“須用戶登錄"，或須獲取訪問級別為"隱私數(shù)據(jù)須用戶登錄"的隱私數(shù)據(jù)時，就需要sessionkey.在測試環(huán)境下獲取SessionKey，見如何獲取sessionkey?。
3）可以自定義App Key，用自己申請的App Key和App Secret來測試。
【界面預覽】
2、在正式環(huán)境下使用API測試工具須注意3點：
1）正式環(huán)境下的數(shù)據(jù)都是真實的數(shù)據(jù)。
2）用系統(tǒng)默認的App Key測試時，通過點擊“綁定用戶”并用商家賬號登錄淘寶網(wǎng)來獲取SessionKey，SessionKey有效時間為半個小時。如果要換商家測試，那么再次點擊“綁定用戶”重新獲取SessionKey即可。綁定成功后，點擊“提交測試”。
3）用自定義的App Key和App Secret測試時，在正式環(huán)境下獲取SessionKey，見如何獲取sessionkey?。
【界面預覽】
3、常見問題：
1）參數(shù)傳入錯誤。一般是藍色星號的參數(shù)沒有傳入。紅色星號的參數(shù)為必傳參數(shù)。還可能傳入?yún)?shù)格式或者類型不對。錯誤排查參考錯誤碼一覽文檔、快速排查問題、錯誤碼排查工具。
2）點擊提交測試沒反應。清除緩存或者換瀏覽器，但少數(shù)接口確實需要一定時間才能生成返回結(jié)果，如taobao.trades.sold.get 搜索當前會話用戶作為賣家已賣出的交易數(shù)據(jù)。
3）接口調(diào)用限制只能塔內(nèi)調(diào)用，如何使用測試工具。
在開發(fā)者中心后臺——聚石塔本地測試添加需要測試的nick，就可以進行塔外IP測試了。
二、API屬性工具
API屬性工具，它的主要功能是生成商品屬性(props)、銷售屬性(sku_properties)、自 定義類目屬性(input_pids)和自定義屬性值(input_str)。首先，選擇商品類目，然后填寫屬性表單，最后點擊“提交”就生成各種屬性串 了。帶*的為商品的必須屬性，生成的屬性串可作為訪問API的參數(shù)。屬性工具鏈接 //open.taobao.com/api_tool/props/
1、界面預覽
2、使用介紹
數(shù)據(jù)環(huán)境可選擇測試和正式，測試表示沙箱環(huán)境，正式表示正式環(huán)境。商品類目，可用taobao.itemcats.get 獲取后臺供賣家發(fā)布商品的標準商品類目獲取。關(guān)鍵屬性和銷售屬性以及非關(guān)鍵屬性可用taobao.itemprops.get 獲取標準商品類目屬性獲取。填選好相關(guān)參數(shù)點擊提交就可以生成相關(guān)參數(shù)。顯示在右邊生成參數(shù)區(qū)域。一般用于發(fā)布產(chǎn)品和發(fā)布商品。
三、錯誤碼排查工具
1、工具介紹
通過API 名稱和錯誤信息，可以快速定位錯誤原因，從而可以幫助ISV自己快速解決調(diào)用TOP接口過程中遇到的問題。訪問地址： //open.taobao.com/apitools/errorCodeSearch.htm 。
2、操作步驟
輸入API名稱（必填）和錯誤碼（或者請求TOP獲取完整的錯誤信息），點擊搜索按鈕，獲取到具體的錯誤信息
3、執(zhí)行邏輯
1）只輸入API名稱，返回該API下所有的業(yè)務錯誤碼信息。
2）輸入API名稱和具體的錯誤碼（錯誤body），返回該API下具體的錯誤碼信息。
3）如果未搜索到，提示未找到改錯誤信息。TOP會定期掃描，補充錯誤碼信息。
4、具體示例
1）只輸入API名稱，返回該API下所有的業(yè)務錯誤碼信息。
2）輸入API名稱和具體的錯誤碼（錯誤body），返回該API下具體的錯誤碼信息。
3）輸入API名稱和錯誤Body，即請求top返回的完整的錯誤信息，json 或xml格式
4）點擊錯誤信息鏈接，調(diào)到錯誤碼具體解釋頁面
注：我們會不斷的對該錯誤信息進行優(yōu)化
FAQ
- 關(guān)于此文檔暫時還沒有FAQ