授權簽名與SDK
登錄授權相關
@
1、什么是授權，如何授權？
所謂授權，即獲取 Access Token ，應用獲取到了Access Token 即意味著取得了用戶的授權，可以替用戶向TOP（開放平臺）請求用戶的隱私信息（如商品、訂單等）。這里的Access Token（Oauth2.0協(xié)議，當前應用均默認該協(xié)議） 即是原來“TOP授權協(xié)議” 時取到的SessionKey。獲取授權詳細方法可點 這里 參考
2、Access Token（SessionKey） 的有效時長只有24小時，如何提高？
“在線訂購”應用正式環(huán)境測試階段，Access Token 有效時長固定24小時，無法提高，失效后需重新授權；應用上線后（需審核）Access Token有效時長會自動提高（和訂購時長一致），各應用授權有效時長如下：
| 標簽名稱 | 正式測試環(huán)境 | 上線運行中 | 備注 |
| 在線訂購應用 | 24小時 | 訂購時長綁定 | 如應用上線后，用戶訂購1年，則Access Token有效1年。更詳細說明參考這里； |
| xTao合作網站 | 24小時 | 24小時 | |
| 商家后臺系統(tǒng) | 24小時 | 1年 | |
| 店鋪模塊前臺 | 無session | 無session | |
| 店鋪模塊后臺 | 24小時 | 訂購時長綁定 | |
| 新業(yè)務 | 24小時 | 1年 |
@
3、授權報錯: application callback can not match the redirect_uri （錯誤碼：invalid_client），什么原因？
授權時請求url 中的uri 值與應用回調地址不一致導致，修改uri 和回調地址一致即可
4、授權1001 錯誤（此應用不允許當前用戶訪問，下圖所示），如何解決？
該錯誤是給應用授權的用戶未在應用授權列表里，登錄開放平臺應用“授權管理”頁面，綁定需授權用戶即可。只有授權是小部分人使用的應用需要設置（如商家后臺系統(tǒng)、未上線的在線訂購應用）。
 |
5、使用code 獲取Access Token時，報如下錯誤，如何處理？
"error": "invalid_client", "error_description": "authorize code qexkqiJRNXJXEPTjPTWYYsK5486529 invalidate,please authorize again."
授權后回調地址上取得的code 只能使用一次，如果重復使用，則報該錯誤。重新授權或code 重試即可
6、程序如何判斷授權（Access Token）失效時間？
應用程序可記錄用戶授權時間，再結合在獲取Access Token 時返回的expires_in （ Access Token有效時間，單位秒）即可判斷。
7、應用如何支持子賬號授權？
1）應用授權管理頁面勾選“支持淘寶子賬號登錄授權”；2）主賬號給應用授權；3）主賬號登錄賣家中心，給子賬號授予應用權限
8、在線訂購應用上線用戶訂購后，應用程序本身需要做什么操作，或者是怎么去判斷用戶訂購的版本信息等？
用戶（賣家）訂購后在我購買的服務里能看到應用，點"立即使用"就會進入授權頁面（系統(tǒng)自動完成，和正式環(huán)境區(qū)別是，正式環(huán)境需給出授權URL讓用戶訪問），用戶授權后TOP會返回CODE 參數到回調地址上，ISV 用這個參數使用POST方式獲取到賣家nick 等信息（詳細參考這里）。然后再調用服務平臺API （點 這里 查看）進行判斷，用戶訂購的時長，何種套餐等，之后應用再給予相應的權限。
補充：用戶首次訪問（從“賣家中心--我購買的服務”進入），有彈出授權頁面，授權后返回CODE給應用并據此取得nick可判斷用戶身份。雖在這之后第二次、第三次訪問應用，并未彈出授權頁面，但CODE仍會返回到回調地址上
9、有3個淘寶店鋪，現需要在一個應用下，取三個店鋪的商品信息，用淘寶taobao.items.inventory.get +sessionkey只能取到一個店鋪的商品信息。這種情況要如何處理？
分別取到3個店鋪的sessionkey，獲取方法可參考 //open.taobao.com/doc/detail.htm?id=101423 。獲取后參考如下例子獲取商品信息：
如店鋪A 下面有appkey （888 ），現想用taobao.items.inventory.get 取店鋪B 的商品 。
A)取店鋪A 商品時，是店鋪A 給888授權并取得sessionkeyA，然后調api 時傳人sessionkeyA 獲取店鋪A 商品。
B)取店鋪B商品時，是店鋪B給888授權并取得sessionkeyB，然后調api 時，傳人sessionkeyB獲取店鋪B的授權。
10、授權常見錯誤及說明
錯誤信息 | 錯誤原因 |
request method must be get/post | 該請求必須用GET或POST方法 |
client_id is empty | client_id(即appkey)不能為空 |
response_type is empty | response_type不能為空 |
redirect_uri is empty | redirect_uri不能為空 |
grant type is empty | grant type不能為空 |
authorize code is empty | authorize code不能為空 |
unsupported response type, the response type must code or token | response type的值必須為code或者token |
redirect_uri is invalidate | redirect_uri 和在開發(fā)者中心注冊的回調地址不一致 |
the grant type unsupported | grant type值無效 |
authorize reject | 用戶拒絕授權 |
authorize code expire | authorize code失效,請重新授權 |
authorize code xxxx invalidate,please authorize again. | authorize code失效,請重新授權 |
client_secret is invalidate | app secret校驗失敗 |
xss chars included in params, such as <, >, ', " | 請求參數中帶有以下字符：<, >, ', " |
The Application already Bind with user ids:xxx | 授權用戶未在開發(fā)者中心“授權管理”頁面綁定 |
Can not find the client_id:xxxxx | client_id(即appkey)不存在 |
Application need publish | 只有狀態(tài)為“正式環(huán)境測試”和“上線運行中”的應用才允許授權 |
Application xxx need purchase | 必須先訂購才能使用 |
app call back is invalidate | 應用的回調地址不合法 |
application callback can not match the redirect_uri | redirect_uri和事先配置的回調地址不匹配 |
only support http or https | 回調URL只支持https或http協(xié)議 |
application in black list,access forbidden. | app存在黑名單中 |
The application don't need session | 此應用不需要session key，不用刷新session key |
session key num is larger than xx | 有效session key個數超過上限 在控制臺中的授權管理里面進行設置。 |
userid is invalidate | userId 不存在 |
login failure | 用戶登錄失敗 |
login sign failure | 無線登錄簽名校驗失敗 |
taobao staff can't accredit | 淘寶小二不允許訪問 |
subuser can't access | 應用不支持子賬號訪問 |
parent account forbid this sub account to access app. | 父賬號未授權此子賬號訪問應用 |
parent account forbidden | 父賬號未授權或授權已過期 |
refresh token is empty | refresh token為空 |
refresh token is error:xxxx | refresh token內容有誤解析失敗 |
refresh token is invalid | refresh token已經失效 |
refresh times limit exceed | 刷新次數超過上限，一個session key一天最多可刷新60次 |
session expire | 當前會話已經過期，可能用戶瀏覽器暫停太久已經超時 |
OAUTH SERVER ERROR:xxxxx | 系統(tǒng)內部錯誤，請重試 |
Iossdk params is lack | 缺少ios sdk協(xié)議參數 |
iossdk track_id is invalid | ios sdk協(xié)議參數track id校驗失敗。建議核對一下app secret |
iossdk params check failed | ios sdk協(xié)議參數校驗失敗 |
簽名SDK相關
@
1、什么是簽名（sign），如何生成？
參考文檔 //open.taobao.com/doc/detail.htm?id=101617 （第一部分 sign 相關內容）
2、調用api 報“Invalid signature”錯誤，什么原因？
1）AppSecret錯誤，如輸入了錯誤的AppSecret 或AppSecret 被重置過
2）生成簽名時的參數 和 http請求時參數不一致導致錯誤。
3）簽名方法有誤，建議參考我們提供示例代碼 //open.taobao.com/doc/detail.htm?id=112 。
3、sdk的作用及如何下載？
淘寶開放平臺的SDK是由程序自動化生成的代碼包，其中包含了已經開放的API和相應的請求、加密、返回解析等一些必要的功能。登錄到“開發(fā)者中心”通過應用證書頁面即可下載（下載時選擇權限對應的sdk），詳細可參考//open.taobao.com/doc/detail.htm?id=101618
4、appkey有api 調用權限，為什么下載到的sdk中未包含相應的類？
下載sdk時未選擇“權限對應的sdk”導致，進入證書頁面重新下載
5、java sdk中如何設置返回數據格式；及sdk是否支持自定義接口方法？
TaobaoClient client = new DefaultTaobaoClient （）此處括號里面加xml 或json 即可指定 ；不支持自定義接口
FAQ
- 關于此文檔暫時還沒有FAQ