API - 卖家自建开放平台

taobao.top.client.token.get

端topToken获取接口

免费需要授权用户授权介绍查看API收费规则

请求地址

环境	HTTP地址	HTTPS地址	请求方式
正式环境	http://open.ieasynote.com/api	https://open.ieasynote.com/api	POST

公共参数

参数名	类型	必须	描述
method	String	是	API接口名称，例如:taobao.top.client.token.get
app_key	String	是	TOP分配给应用的AppKey，例如：12345678
session	String	是	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请[点击这里]()。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟
v	String	是	API协议版本，可选值：2.0
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5，hmac-sha256
sign	String	是	API输入参数签名结果，签名算法介绍请[点击这里](
format	String	否	响应格式。默认为xml格式，可选值：xml，json
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false

公共响应参数

公共响应参数中，error_response 和 xxx_response只会出现一个

参数名	类型	描述
request_id	String	平台颁发的每次请求访问的唯一标识
error_response	String	请求访问失败时返回的根节点，和 xxxxx_response 只会出现一个
code	String	请求失败返回的错误码，error_response 的子节点
msg	String	请求失败返回的错误信息，error_response 的子节点
sub_code	String	请求失败返回的子错误码，error_response 的子节点
sub_msg	String	请求失败返回的子错误信息，error_response 的子节点
xxxxx_response	String	请求成功返回的根节点，和 error_response 只会出现一个，'xxxxx' 为API名称的下划线模式，本接口为：top_client_token_get_response

请求参数

参数名	类型	必须	示例值	描述
sec_token	String	是	sec_token	sec_token

请求响应参数

请求响应参数是 xxx_response 的子节点

参数名	类型	示例值	描述
result_code	String	200	结果码
token	String	token	token
result_msg	String	token参数有误	失败详情

请求示例代码

将接口地址URL设置成: http://open.ieasynote.com/api

                        
                        
$c = new TopClient;
// WARN: url: http://open.ieasynote.com/api
$c->gatewayUrl = "http://open.ieasynote.com/api";
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TopClientTokenGetRequest;
$req->setSecToken("sec_token");
$resp = $c->execute($req, $sessionKey);

                        
                        
// WARN: url: http://open.ieasynote.com/api
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TopClientTokenGetRequest req = new TopClientTokenGetRequest();
req.setSecToken("sec_token");
TopClientTokenGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

                        
                        
// WARN: url: http://open.ieasynote.com/api
ITopClient client = new DefaultTopClient(url, appkey, secret);
TopClientTokenGetRequest req = new TopClientTokenGetRequest();
req.SecToken = "sec_token";
TopClientTokenGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

                        
                        
# -*- coding: utf-8 -*-
import top.api

req=top.api.TopClientTokenGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.sec_token="sec_token"
try:
    resp= req.getResponse(sessionkey)
    print(resp)
except Exception,e:
    print(e)

                        
                        
curl -X POST 'http://open.ieasynote.com/api' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.top.client.token.get' \
-d 'partner_id=apidoc' \
-d 'session=71f46e93-8049-49d6-8322-7991d2ce7175' \
-d 'sign=88286BC5062C5E781B3DEB57D8A008D4' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-08-24+10%3A20%3A01' \
-d 'v=2.0' \
-d 'sec_token=sec_token'

                        
                        
TopClient = require('./topClient').TopClient;
var client = new TopClient({
    'appkey': 'appkey',
    'appsecret': 'secret',
    'REST_URL': 'http://open.ieasynote.com/api'
});

client.execute('taobao.top.client.token.get', {
    'sec_token':'sec_token'
}, function(error, response) {
    if (!error) console.log(response);
    else console.log(error);
})

                        
                        
package main;

import (
    "fmt"
    "topsdk"
    "topsdk/defaultability"
    "topsdk/defaultability/request"
)

func main() {
    client := topsdk.NewDefaultTopClient("<your-appkey>","<your-appsecret>","<top-gateway-url>",20000,20000)
    ability := defaultability.NewDefaultability(&client)


    req := request.TaobaoTopClientTokenGetRequest{}
    req.SetSecToken("sec_token")


    resp, err := ability.TaobaoTopClientTokenGet(&req)
    if(err != nil) {
        fmt.Println(err)
    } else {
        fmt.Println(resp.Body)
    }
}

                        
                        
<?php
require "../vendor/autoload.php";
use Topsdk\Topapi\TopApiClient;
use Topsdk\Topapi\Defaultability\Request\TaobaoTopClientTokenGetRequest;
use Topsdk\Topapi\Defaultability\Defaultability;


// create Client
// WARN: url: http://open.ieasynote.com/api
$client = new TopApiClient("<your-appkey>","<your-appsecret>","<top-gateway-url>");
$ability = new Defaultability($client);

// create domain

// create request
$request = new TaobaoTopClientTokenGetRequest();
$request->setSecToken("sec_token");

$response = $ability->taobaoTopClientTokenGet($request);
var_dump($response);

                        
                        
import com.alibaba.fastjson.JSON;
import java.io.File;
import java.util.ArrayList;
import java.util.Date;
import com.taobao.top.TopApiClient;
import com.taobao.top.DefaultTopApiClient;
import com.taobao.top.TopFileItem;
import com.taobao.top.defaultability.Defaultability;
import com.taobao.top.defaultability.request.TaobaoTopClientTokenGetRequest;
import com.taobao.top.defaultability.response.TaobaoTopClientTokenGetResponse;

public class Main {

    public static void main(String[] args) throws Exception {
        // create Client
        // WARN: url: http://open.ieasynote.com/api
        TopApiClient client = new DefaultTopApiClient("<your-appkey>","<your-appsecret>","<top-gateway-url>");
        Defaultability apiPackage = new Defaultability(client);
        // create domain

        // create request
        TaobaoTopClientTokenGetRequest request = new TaobaoTopClientTokenGetRequest();
        request.setSecToken("sec_token");

        TaobaoTopClientTokenGetResponse response = apiPackage.taobaoTopClientTokenGet(request);
        if(!response.isSuccess()){
            System.out.println(response.getSubMsg());
        }
        System.out.println(JSON.toJSONString(response));
    }
}

响应示例

                        
                        
<top_client_token_get_response>
    <result_code>200</result_code>
    <token>token</token>
    <result_msg>token参数有误</result_msg>
</top_client_token_get_response>

                        
                        
{
    "error_response":{
        "msg":"Remote service error",
        "code":50,
        "sub_msg":"非法参数",
        "sub_code":"isv.invalid-parameter"
    }
}

异常响应示例

                        
                            
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>参数异常</sub_msg>
</error_response>

                        
                            
{
    "error_response":{
        "msg":"Remote service error",
        "code":50,
        "sub_msg":"XXX",
        "sub_code":"isv.invalid-parameter"
    }
}

错误码描述

错误码	错误消息	解决方案
暂无错误解释