文档中心 > API类目 > 淘金币API

taobao.coin.token.get (获取淘金币接口令牌)

获取淘金币接口令牌。令牌作为淘金币平台的信任凭证,获取令牌时会对用户进行检查,如用户存在可疑行为(如使用外挂)会要求二次验证(目前是识别验证码)。因此您的应用应该根据本接口返回值作是否展示验证码的逻辑,用户输入验证码后将验证码作入参请求本接口,通过后会返回令牌。 淘金币以下接口,需要持有该令牌才能调用—— 1、taobao.coin.buyer.add 2、taobao.coin.buyer.consume 3、taobao.coin.seller.give

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
buyer_nick String 必须 demo 买家nick, 使用top混淆nick
user_agent String 可选 demo 原请求头部信息
remote_ip String 可选 demo 客户端IP
x_forwarded_for String 可选 demo 原请求头部信息
header Json 可选 {code:2323} 原请求头部信息
check_code String 可选 abcd 需要二次验证时,用户识别的验证码字符串

响应参数

名称 类型 示例值 描述
trace_id String xxbvv 故障排查跟踪ID,联系淘金币服务方排查请提供该值
token String aabb 获取到的TOKEN值
status Number 0 获取TOKEN时会对用户进行验证,不通过用户需要通过验证码进行二次验证。 0-验证通过,-1-需要验证码验证
check_code CheckCodeValue 验证码信息 当status=-1时取验证码信息给用户二次验证
  • └ check_code_url
  • String
  • http://xxx.taobao.com/checkcode
  • 验证码图片URL
  • └ status
  • Number
  • 1
  • 0-不需要验证码,1-验证通过,-1-需要验证码,-2-验证码错误

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CoinTokenGetRequest req = new CoinTokenGetRequest();
req.setBuyerNick("demo");
req.setUserAgent("demo");
req.setRemoteIp("demo");
req.setXForwardedFor("demo");
req.setHeaderString("{code:2323}");
req.setCheckCode("abcd");
CoinTokenGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<coin_token_get_response>
    <trace_id>xxbvv</trace_id>
    <token>aabb</token>
    <status>0</status>
    <check_code>
        <check_code_url>http://xxx.taobao.com/checkcode</check_code_url>
        <status>1</status>
    </check_code>
</coin_token_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isp.token-generate-fail 获取TOKEN失败 重试

API工具

如何获得此API

FAQ

返回
顶部