# 淘宝授权

重要提示

所有需要tbName的API都需要先淘宝授权,授权之后即可得到tbName并取得调用API的权限;

淘宝授权一次有效期是一个月,在过期之前的3天会发邮件提示重新授权,所以请务必保证注册时填写的邮箱地址可正常收发邮件;

如果注册时填写的邮箱地址不正确,可以登陆控制台修改,修改邮箱地址

# 授权流程

  1. 没有账号的需要先注册获取appkey
    已有账号可直接登陆查看appkey
    已有appkey和appsecret的直接进行第2步

  2. 授权基础地址: https://open.ysdby.net/user/oauth

  3. 打开方式:拼接下列参数在浏览器中打开,输入淘宝账号密码或者扫码即可完成授权,例:

https://open.ysdby.net/user/oauth?appkey=xxx&appsecret=xxx&callbackUrl=http%3a%2f%2fwww.xxx.com

名称 类型 必须 说明
appkey String 登陆控制台查看
apptoken String 详见用前必读
callbackUrl String 回调地址,需要urlencode,授权成功之后会将授权信息回调到您的服务器;如果没有callbackUrl会直接在浏览器中展示授权结果;
  1. 授权回调,授权之后会跳转到上面传入的callbackUrl并附带上授权结果

//成功时

http://www.xxx.com?errcode=0&errMsg=授权成功&tbName=xxx&tbId=xxx&oauthExtTime=2019-01-01 01:01:01&token=8261406f113ab40de5250ca9ec0ef0c8

//失败时

http://www.xxx.com?errcode=1&errmsg=授权失败

说明

tbId:授权的淘宝Id,后面的接口都要用到;

tbName: 授权的淘宝会员名,后面的接口都要用到,和tbId二选一即可;

oauthExtTime: 授权到期时间,淘宝的授权有效期为一个月,过期之前需重新授权才能继续使用;

token: 用来验证回调的真实性,tbName+appkey的md5值: md5(tbName+appkey)