无线端授权规范

目前无线端支持两种授权方式：JS 授权、Web Oauth授权。

如果您只需要调用JS 相关的API，仅使用JS 授权即可。

如果您需要获取accesstoken调用其他TOP API，可以使用Web Oauth授权。（无线端，请务必使用无线相关的样式，注意view参数设置wap）

JS授权

取得用户同意后，部分需要开通权限的接口才能使用。若仍有部分接口不能使用，请检查自己应用权限包是否包含接口。

/**
* @param options 参数，支持boolean型 function 或object 或者不传第1个参数 直接为function表示不强制授权
* @param [options.refresh=false] 是否重新授权 true: 即使已经有授权，会清掉之前的授权信息重启授权流程, false:授权有效直接返回授权成功
*/
Tida.doAuth(options,function(data){
    if(data.finish){
        // 授权成功 可以顺利调用需要授权的接口了
    }else {
        // 未能成功授权
    }
});
 
// 另一种调用
Tida.doAuth(function(data){
    if(data.finish){
        // 授权成功 可以顺利调用需要授权的接口了
    }else {
        // 未能成功授权
    }
});
 
// 强制授权 每次都会弹出授权框
Tida.doAuth(true, function(data){
    if(data.finish){
        // 授权成功 可以顺利调用需要授权的接口了
    }else {
        // 未能成功授权
    }
});

data 格式：

{
    errorCode: 0, //通用错误码
    errorMessage: "用户已授权",
    finish: true //true为授权成功 false授权失败 授权失败请参考data.errorCode
}

Web Oauth授权

此流程要求ISV应用有Web Server应用，能够保存应用本身的密钥以及状态，可以通过https直接访问淘宝的授权服务器。

无线端样式：

方式1：直接使用oauth.m.taobao.com域名，其他参数不需要变更（推荐）

方式2：使用oauth.taobao.com域名必须加 view=wap 参数来获取无线端的样式

1、请求入口地址

1）获取授权码（code）
 正式环境：https://oauth.m.taobao.com/authorize
2）获取访问令牌（access_token）
 正式环境：https://oauth.m.taobao.com/token

2、授权操作步骤
    实际进行授权操作时，测试的数据 client_id、client_secret、redirect_uri 均需要根据自己创建的应用实际数据给予替换，不能拿示例中给出的值直接进行测试，以免影响实际测试效果。下图为Server-side flow 授权方式流程图，以下按流程图逐步说明。

1）拼接授权url
拼接用户授权需访问url ，示例及参数说明如下：
https://oauth.m.taobao.com/authorize?response_type=code&client_id=23075594&redirect_uri=http://www.oauth.net/2/&state=1212

2）引导用户登录授权
引导用户通过浏览器访问以上授权url，将弹出如下登录页面。用户输入账号、密码点“登录”按钮，即可进入授权页面。

3）获取code
上图页面，若用户点“授权”按钮后，TOP会将授权码code 返回到了回调地址上，应用可以获取并使用该code去换取access_token；
若用户未点授权而是点了“取消”按钮，则返回如下结果，其中error为错误码，error_description为错误描述。分别如下图所示：

4）换取access_token
利用linux 的curl 命令 获取access_token（授权令牌），如下；对于应用程序，可以参考文档**示例**这里的示例代码。

curl -i -d "code=OxlukWofLrB1Db1M6aJGF8x2332458&grant_type=authorization_code&client_id=23075594&
client_secret=69a1469a1469a1469a14a9bf269a14&redirect_uri=http://www.oauth.net/2/ "https://oauth.m.taobao.com/token

换取access_token返回值示例

FAQ