本幫助文檔,，主要對大家在使用沙箱進(jìn)行測試過程中遇到的問題進(jìn)行歸納總結(jié),，以便幫助大家可以快速解決測試過程中遇到問題 。同時,，如果有疑問或?qū)ι诚溆薪ㄗh或意見,，請到支持中心進(jìn)行反饋。

目錄結(jié)構(gòu)

沙箱簡介

淘寶沙箱環(huán)境是淘寶開放平臺（TOP）提供給獨立軟件開發(fā)商（ISV）的測試環(huán)境,。數(shù)據(jù)完全獨立,，大部分API已經(jīng)部署到該環(huán)境中供ISV進(jìn)行API的功能測試，對于APP的調(diào)用量無限制,，但獲取大批量數(shù)據(jù)時,，超時率會較線上環(huán)境更高。對于整個環(huán)境,，我們力求做到：

• 業(yè)務(wù)全面&實時：新的沙箱環(huán)境,，業(yè)務(wù)和正式環(huán)境保持實時同步更新，同時我們會逐步在沙箱中提供更多的功能,，以便ISV可以進(jìn)行全面測試.
• 系統(tǒng)&業(yè)務(wù)穩(wěn)定：我們會對系統(tǒng),、應(yīng)用、業(yè)務(wù)進(jìn)行監(jiān)控,，保證沙箱環(huán)境的高可用。
• 操作易用：目前商品管理,、交易管理,、物流、退款,、評價管理都提供了淘寶的原始頁面,。

對于正式環(huán)境TOP提供的各種服務(wù)協(xié)議，沙箱環(huán)境的調(diào)用方式和線上一致,，唯一不同的就是沙箱的訪問地址和測試賬號

沙箱中,，提供了商品管理、交易管理,、評價管理,、退款管理、發(fā)貨管理等核心功能的原始操作頁面,，方便ISV在測試的過程中準(zhǔn)備數(shù)據(jù),。

沙箱中去除了對淘寶助理的依賴,，而數(shù)據(jù)準(zhǔn)備將以賣家管理后臺的形式對外提供。

測試約定

在整個測試過程中進(jìn)行以下約定：

• 沙箱所有注冊賬戶均以sandbox_開頭,，否則登錄將跳到錯誤頁面,。
• 沙箱所有添加的商品，標(biāo)題中必須包含沙箱測試,，否則商品詳情頁將跳到錯誤頁面,。
• 沙箱中老的使用Scope方式的短授權(quán)已經(jīng)下線，對于訪問短授權(quán)接口,，必須升級到新的TOP平臺安全體系進(jìn)行,。
• 沙箱中所有需要用到驗證碼的地方，統(tǒng)一使用8888,。
• 測試appkey在沙箱中可以調(diào)所有的接口,，同時沒有流量限制。如果遇到有流量限制,，則請到正式環(huán)境開發(fā)者中心的應(yīng)用配置沙箱環(huán)境頁面重新更新下即可,。

訪問地址

淘寶沙箱的域名是的，因此所有訪問沙箱的地址可參考正式環(huán)境的地址,，將域名后綴由taobao.com改成,。下面是一些常用的地址入口：

• 沙箱首頁：http://www.
• Mini沙箱首頁：http://mini.
• TOP訪問入口^HTTP：http://gw.api./router/rest
• TOP訪問入口^HTTPS：https://gw.api./router/rest
• 容器授權(quán)入口^{TOP協(xié)議}：http://container.api./container
• 容器授權(quán)入口^{OAuth2協(xié)議}：https://oauth./authorize
• 沙箱分銷商頁面^{分銷數(shù)據(jù)管理}：http://fenxiao./distributor/index.htm
• 沙箱供應(yīng)商頁面^{分銷數(shù)據(jù)管理}：http://fenxiao./supplier/index.htm
• 物流寶聯(lián)調(diào)平臺^{物流寶數(shù)據(jù)管理}：http://fbi./
• 支付寶沙箱頁面^{支付寶接口數(shù)據(jù)準(zhǔn)備}：http://sandbox./

測試賬號創(chuàng)建

在使用沙箱的過程中，根據(jù)不同的業(yè)務(wù)場景,，我們需要對以下賬號類型有所了解：

• 淘寶賬號：

  根據(jù)業(yè)務(wù)類型,，淘寶賬號分：集市賣家賬號 和商城賣家賬號。集市賣家可購買商品,，因此也可以作為買家賬號,，商城賣家賬號不能購買商品。目前,，可通過以下兩種方式獲?。?/p>

  • 系統(tǒng)默認(rèn)：系統(tǒng)默認(rèn)賬號密碼統(tǒng)一為：taobao1234 ， 賬號如下：
    • 商城賣家賬號 -> sandbox_c_1 & sandbox_b_00~sandbox_b_29 -> 例如：sandbox_c_1 ,， sandbox_b_01
    • 集市賣家賬號 -> sandbox_c_2~sandbox_c_20 -> 例如：sandbox_c_2
  
  
  • 個人注冊：個人注冊地址：沙箱注冊,，如下圖：
    
    • 普通用戶表示集市賣家，可購買或發(fā)布商品,，商城用戶為商城賣家,，不能購買商品，如果需要發(fā)布商品,，則需要先授權(quán)品牌或者類目,。
    • 沙箱的用戶名必須以sandbox開頭，否則將創(chuàng)建失敗。
    • 在創(chuàng)建用戶時,，系統(tǒng)將默認(rèn)創(chuàng)建支付寶賬戶,，名稱：Mini淘寶用戶名@，如：sandbox_c_11@,。支付寶登錄密碼和支付密碼和淘寶賬號密碼相同,。可到我的支付寶進(jìn)行管理,。

  對于這些創(chuàng)建的用戶,，如果需要發(fā)貨 ，請到物流地址庫進(jìn)行管理賣家發(fā)貨地址和退貨地址,。否則將不能發(fā)貨,。



• AppKey賬號：

  目前沙箱的測試APPKEY賬號，是通過線上賬號直接同步過來的,，ISV測試過程中可在正式環(huán)境配置沙箱管理頁面對APPKEY相關(guān)信息進(jìn)行管理,。同時，也提供一個默認(rèn)的測試賬號：appkey:test , Secret:test,。沙箱appkey賬號管理頁面進(jìn)入流程如下：

  訪問正式環(huán)境我的應(yīng)用后臺,，選擇一個我當(dāng)前創(chuàng)建的應(yīng)用進(jìn)入，之后選擇配置沙箱環(huán)境選項,，進(jìn)行配置沙箱管理頁面,，如下圖：

  
  
  • 該頁面將展現(xiàn)沙箱環(huán)境中的appkey 和 Secret。
  • 回調(diào)URL是用戶接收授權(quán)信息和消息通知,至于其他用處和線上保持一致,。
  • 出于安全考慮,，TOP將對短授權(quán)機(jī)制進(jìn)行升級，統(tǒng)一切換到新的安全機(jī)制上來,，而下面那些配置項,，ISV可自行填寫，從而獲取更高級別的安全等級,。老的安全機(jī)制在沙箱中已經(jīng)禁用,，如果測試短授權(quán)類接口，請升級到新的安全級別上,。


• SessionKey：Sessionkey 獲取可參考應(yīng)用授權(quán)獲取。如果想快速獲取,，可使用Sessionkey獲取進(jìn)行,。
• 支付寶賬號：沙箱交易流程中，對與支付寶相關(guān)的操作都是直接mock,，因此,，沙箱中的支付寶賬號僅僅是為支付寶接口測試使用的。在注冊淘寶賬戶時，系統(tǒng)會默認(rèn)創(chuàng)建支付寶賬戶,，同時用戶也可以到我的支付寶頁面進(jìn)行管理,。綁定的支付寶賬戶名稱必須以淘寶賬戶名開頭。
  


• 物流寶賬號： 物流寶接口測試中用到的測試賬號,，以及他們之間的管理,，可到物流寶聯(lián)調(diào)平臺進(jìn)行創(chuàng)建和維護(hù)。若在物流寶聯(lián)調(diào)平臺上創(chuàng)建的賬戶不能購買或者發(fā)布寶貝等,，可到沙箱測試賬號修復(fù)頁面進(jìn)行修復(fù),。


• 分銷賬號賬號：分銷接口測試用到的賬戶關(guān)系如下：
  

  賬號類型	賬號列表	示例
  商城賣家賬號	sandbox_b_00~sandbox_b_29	sandbox_b_01
  集市賣家賬號	sandbox_c_1~sandbox_c_20	sandbox_c_1
  分銷平臺供應(yīng)商賬號	sandbox_b_20~sandbox_b_29	sandbox_b_20
  分銷平臺分銷商賬號	sandbox_c_1~sandbox_c_20	sandbox_c_1

  一個供應(yīng)商對應(yīng)多個分銷商：

  供應(yīng)商賬號	分銷商賬號	供應(yīng)商賬號	分銷商賬號
  sandbox_b_20	sandbox_c_1 sandbox_c_2	sandbox_b_25	sandbox_c_11 sandbox_c_12
  sandbox_b_21	sandbox_c_3 sandbox_c_4	sandbox_b_26	sandbox_c_13 sandbox_c_14
  sandbox_b_22	sandbox_c_5 sandbox_c_6	sandbox_b_27	sandbox_c_15 sandbox_c_16
  sandbox_b_23	sandbox_c_7 sandbox_c_8	sandbox_b_28	sandbox_c_17 sandbox_c_18
  sandbox_b_24	sandbox_c_9 sandbox_c_10	sandbox_b_29	sandbox_c_19 sandbox_c_20

  多個供應(yīng)商對應(yīng)一個分銷商：

  供應(yīng)商賬號	分銷商賬號	供應(yīng)商賬號	分銷商賬號
  sandbox_b_20 sandbox_b_21	sandbox_c_1	sandbox_b_26 sandbox_b_27	sandbox_c_4
  sandbox_b_22 sandbox_b_23	sandbox_c_2	sandbox_b_28 sandbox_b_29	sandbox_c_5
  sandbox_b_24 sandbox_b_25	sandbox_c_3

開發(fā)核心技術(shù)

本類目主要從API調(diào)用，用戶授權(quán),，登錄簽名校驗以及TOP提供的多樣化服務(wù)等幾個方面介紹當(dāng)前淘寶開放平臺的常用核心實現(xiàn)技術(shù)在沙箱中的使用,，幫助開發(fā)者能夠在沙箱環(huán)境做更全面的測試。

同時,，由于這部分內(nèi)容在開放平臺文檔中心中都有詳細(xì)的介紹,，因此本幫助文檔將重點介紹如何使用，具體細(xì)節(jié),，可到開放平臺