淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

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

名称	类型	是否必须	示例值	描述
tmp_pen_name	String	可选	1	tmpPenName
ali_email	String	可选	1	aliEmail
pen_name	String	可选	1	penName
group_id	Number	可选	1	groupId
page_size	Number	可选	1	pageSize
source	Number	可选	1	source
group_ord	Number	可选	1	groupOrd
type	Number	可选	1	type
verify_start_date	String	可选	1	verifyStartDate
sign_type	Number	可选	1	signType
edit_type	Number	可选	1	editType
order	String	可选	1	order
qq	String	可选	1	qq
sign_access	Number	可选	1	signAccess
apply_start_date	String	可选	1	applyStartDate
mobile	String	可选	1	mobile
author_sex	Number	可选	1	authorSex
source_type	Number	可选	1	source_type
apply_end_date	String	可选	1	applyEndDate
sort	String	可选	1	sort
author_id	Number	可选	1	authorId
user_id	Number	可选	1	userId
real_name	String	可选	1	realName
pen_name_status	Number	可选	1	penNameStatus
ali_card_type	Number	可选	1	aliCardType
verify_end_date	String	可选	1	verifyEndDate
page	Number	可选	1	page
is_claim	Number	可选	1	isClaim
card_number	String	可选	1	cardNumber
action_name	String	可选	1	actionName
status	Number	可选	1	status
desensitization	Number	可选	1	desensitization

名称	类型	示例值	描述
result	CommonResponse		result
data OgnvAliAuthorAuditListResp data └ total Number 96 total author_list AuthorInfoItem [] authorList └ tmp_pen_name String tmpPenName tmpPenName └ verify_date String 2021-08-24 17:13:02 verifyDate └ pen_name String 缓存 penName └ edit Number 8 edit └ group_id Number 4 groupId └ claim_infos String [] claimInfo └ mobile String 11111111111 mobile └ author_sex Number 1 authorSex └ group_ord Number 0 groupOrd └ author_id Number 952729015 authorId └ user_id Number 268542438 userId └ real_name String 33 realName └ migrate_statue Number 0 migrateStatue └ pen_name_status Number 3 penNameStatus └ old_pen_name String oldPenName oldPenName └ online_edit_id Number 0 onlineEditId └ sign_type Number 1 signType grouplist GroupItem [] grouplist └ qq String qq qq └ opt_name String baijiankai optName └ is_assign Number 1 isAssign └ group_id Number 1 groupId └ edit_email String qq editEmail └ edit_nick_name String qq editNickName └ update_time Number 1629809496 updateTime └ group_ord Number 1 groupOrd └ edit_name String qq editName └ insert_time Number 1629809496 insertTime └ back_name String qq backName └ id Number 148 id └ group_level Number 102 groupLevel └ apply_date String 2021-08-24 16:31:59 applyDate └ status Number 3 status └ page Number 96 page └ state Number 200 state └ message String ok message

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsRequest req = new AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsRequest();
req.setTmpPenName("1");
req.setAliEmail("1");
req.setPenName("1");
req.setGroupId(1L);
req.setPageSize(1L);
req.setSource(1L);
req.setGroupOrd(1L);
req.setType(1L);
req.setVerifyStartDate("1");
req.setSignType(1L);
req.setEditType(1L);
req.setOrder("1");
req.setQq("1");
req.setSignAccess(1L);
req.setApplyStartDate("1");
req.setMobile("1");
req.setAuthorSex(1L);
req.setSourceType(1L);
req.setApplyEndDate("1");
req.setSort("1");
req.setAuthorId(1L);
req.setUserId(1L);
req.setRealName("1");
req.setPenNameStatus(1L);
req.setAliCardType(1L);
req.setVerifyEndDate("1");
req.setPage(1L);
req.setIsClaim(1L);
req.setCardNumber("1");
req.setActionName("1");
req.setStatus(1L);
req.setDesensitization(1L);
AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsRequest req = new AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsRequest();
req.TmpPenName = "1";
req.AliEmail = "1";
req.PenName = "1";
req.GroupId = 1L;
req.PageSize = 1L;
req.Source = 1L;
req.GroupOrd = 1L;
req.Type = 1L;
req.VerifyStartDate = "1";
req.SignType = 1L;
req.EditType = 1L;
req.Order = "1";
req.Qq = "1";
req.SignAccess = 1L;
req.ApplyStartDate = "1";
req.Mobile = "1";
req.AuthorSex = 1L;
req.SourceType = 1L;
req.ApplyEndDate = "1";
req.Sort = "1";
req.AuthorId = 1L;
req.UserId = 1L;
req.RealName = "1";
req.PenNameStatus = 1L;
req.AliCardType = 1L;
req.VerifyEndDate = "1";
req.Page = 1L;
req.IsClaim = 1L;
req.CardNumber = "1";
req.ActionName = "1";
req.Status = 1L;
req.Desensitization = 1L;
AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaShuqiOriginalBackendOgnvaliauthorGetauditauthorsRequest;
$req->setTmpPenName("1");
$req->setAliEmail("1");
$req->setPenName("1");
$req->setGroupId("1");
$req->setPageSize("1");
$req->setSource("1");
$req->setGroupOrd("1");
$req->setType("1");
$req->setVerifyStartDate("1");
$req->setSignType("1");
$req->setEditType("1");
$req->setOrder("1");
$req->setQq("1");
$req->setSignAccess("1");
$req->setApplyStartDate("1");
$req->setMobile("1");
$req->setAuthorSex("1");
$req->setSourceType("1");
$req->setApplyEndDate("1");
$req->setSort("1");
$req->setAuthorId("1");
$req->setUserId("1");
$req->setRealName("1");
$req->setPenNameStatus("1");
$req->setAliCardType("1");
$req->setVerifyEndDate("1");
$req->setPage("1");
$req->setIsClaim("1");
$req->setCardNumber("1");
$req->setActionName("1");
$req->setStatus("1");
$req->setDesensitization("1");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.shuqi.original.backend.ognvaliauthor.getauditauthors' \
-d 'partner_id=apidoc' \
-d 'sign=33E26E7EAE4AF973C601B1850D7B3335' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-19+18%3A38%3A29' \
-d 'v=2.0' \
-d 'action_name=1' \
-d 'ali_card_type=1' \
-d 'ali_email=1' \
-d 'apply_end_date=1' \
-d 'apply_start_date=1' \
-d 'author_id=1' \
-d 'author_sex=1' \
-d 'card_number=1' \
-d 'desensitization=1' \
-d 'edit_type=1' \
-d 'group_id=1' \
-d 'group_ord=1' \
-d 'is_claim=1' \
-d 'mobile=1' \
-d 'order=1' \
-d 'page=1' \
-d 'page_size=1' \
-d 'pen_name=1' \
-d 'pen_name_status=1' \
-d 'qq=1' \
-d 'real_name=1' \
-d 'sign_access=1' \
-d 'sign_type=1' \
-d 'sort=1' \
-d 'source=1' \
-d 'source_type=1' \
-d 'status=1' \
-d 'tmp_pen_name=1' \
-d 'type=1' \
-d 'user_id=1' \
-d 'verify_end_date=1' \
-d 'verify_start_date=1'

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

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

req.tmp_pen_name="1"
req.ali_email="1"
req.pen_name="1"
req.group_id=1
req.page_size=1
req.source=1
req.group_ord=1
req.type=1
req.verify_start_date="1"
req.sign_type=1
req.edit_type=1
req.order="1"
req.qq="1"
req.sign_access=1
req.apply_start_date="1"
req.mobile="1"
req.author_sex=1
req.source_type=1
req.apply_end_date="1"
req.sort="1"
req.author_id=1
req.user_id=1
req.real_name="1"
req.pen_name_status=1
req.ali_card_type=1
req.verify_end_date="1"
req.page=1
req.is_claim=1
req.card_number="1"
req.action_name="1"
req.status=1
req.desensitization=1
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.shuqi.original.backend.ognvaliauthor.getauditauthors");
add_param(pRequest,"tmp_pen_name","1");
add_param(pRequest,"ali_email","1");
add_param(pRequest,"pen_name","1");
add_param(pRequest,"group_id","1");
add_param(pRequest,"page_size","1");
add_param(pRequest,"source","1");
add_param(pRequest,"group_ord","1");
add_param(pRequest,"type","1");
add_param(pRequest,"verify_start_date","1");
add_param(pRequest,"sign_type","1");
add_param(pRequest,"edit_type","1");
add_param(pRequest,"order","1");
add_param(pRequest,"qq","1");
add_param(pRequest,"sign_access","1");
add_param(pRequest,"apply_start_date","1");
add_param(pRequest,"mobile","1");
add_param(pRequest,"author_sex","1");
add_param(pRequest,"source_type","1");
add_param(pRequest,"apply_end_date","1");
add_param(pRequest,"sort","1");
add_param(pRequest,"author_id","1");
add_param(pRequest,"user_id","1");
add_param(pRequest,"real_name","1");
add_param(pRequest,"pen_name_status","1");
add_param(pRequest,"ali_card_type","1");
add_param(pRequest,"verify_end_date","1");
add_param(pRequest,"page","1");
add_param(pRequest,"is_claim","1");
add_param(pRequest,"card_number","1");
add_param(pRequest,"action_name","1");
add_param(pRequest,"status","1");
add_param(pRequest,"desensitization","1");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

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

client.execute('alibaba.shuqi.original.backend.ognvaliauthor.getauditauthors', {
	'tmp_pen_name':'1',
	'ali_email':'1',
	'pen_name':'1',
	'group_id':'1',
	'page_size':'1',
	'source':'1',
	'group_ord':'1',
	'type':'1',
	'verify_start_date':'1',
	'sign_type':'1',
	'edit_type':'1',
	'order':'1',
	'qq':'1',
	'sign_access':'1',
	'apply_start_date':'1',
	'mobile':'1',
	'author_sex':'1',
	'source_type':'1',
	'apply_end_date':'1',
	'sort':'1',
	'author_id':'1',
	'user_id':'1',
	'real_name':'1',
	'pen_name_status':'1',
	'ali_card_type':'1',
	'verify_end_date':'1',
	'page':'1',
	'is_claim':'1',
	'card_number':'1',
	'action_name':'1',
	'status':'1',
	'desensitization':'1'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_shuqi_original_backend_ognvaliauthor_getauditauthors_response>
    <result>
        <data>
            <total>96</total>
            <author_list>
                <author_info_item>
                    <tmp_pen_name>tmpPenName</tmp_pen_name>
                    <verify_date>2021-08-24 17:13:02</verify_date>
                    <pen_name>缓存</pen_name>
                    <edit>8</edit>
                    <group_id>4</group_id>
                    <claim_infos>
                        <string></string>
                    </claim_infos>
                    <mobile>11111111111</mobile>
                    <author_sex>1</author_sex>
                    <group_ord>0</group_ord>
                    <author_id>952729015</author_id>
                    <user_id>268542438</user_id>
                    <real_name>33</real_name>
                    <migrate_statue>0</migrate_statue>
                    <pen_name_status>3</pen_name_status>
                    <old_pen_name>oldPenName</old_pen_name>
                    <online_edit_id>0</online_edit_id>
                    <sign_type>1</sign_type>
                    <grouplist>
                        <group_item>
                            <qq>qq</qq>
                            <opt_name>baijiankai</opt_name>
                            <is_assign>1</is_assign>
                            <group_id>1</group_id>
                            <edit_email>qq</edit_email>
                            <edit_nick_name>qq</edit_nick_name>
                            <update_time>1629809496</update_time>
                            <group_ord>1</group_ord>
                            <edit_name>qq</edit_name>
                            <insert_time>1629809496</insert_time>
                            <back_name>qq</back_name>
                            <id>148</id>
                            <group_level>102</group_level>
                        </group_item>
                    </grouplist>
                    <apply_date>2021-08-24 16:31:59</apply_date>
                    <status>3</status>
                </author_info_item>
            </author_list>
            <page>96</page>
        </data>
        <state>200</state>
        <message>ok</message>
    </result>
</alibaba_shuqi_original_backend_ognvaliauthor_getauditauthors_response>

{
    "alibaba_shuqi_original_backend_ognvaliauthor_getauditauthors_response":{
        "result":{
            "data":{
                "total":96,
                "author_list":{
                    "author_info_item":[
                        {
                            "tmp_pen_name":"tmpPenName",
                            "verify_date":"2021-08-24 17:13:02",
                            "pen_name":"缓存",
                            "edit":8,
                            "group_id":4,
                            "claim_infos":{
                                "string":[
                                    ""
                                ]
                            },
                            "mobile":"11111111111",
                            "author_sex":1,
                            "group_ord":0,
                            "author_id":952729015,
                            "user_id":268542438,
                            "real_name":"33",
                            "migrate_statue":0,
                            "pen_name_status":3,
                            "old_pen_name":"oldPenName",
                            "online_edit_id":0,
                            "sign_type":1,
                            "grouplist":{
                                "group_item":[
                                    {
                                        "qq":"qq",
                                        "opt_name":"baijiankai",
                                        "is_assign":1,
                                        "group_id":1,
                                        "edit_email":"qq",
                                        "edit_nick_name":"qq",
                                        "update_time":1629809496,
                                        "group_ord":1,
                                        "edit_name":"qq",
                                        "insert_time":1629809496,
                                        "back_name":"qq",
                                        "id":148,
                                        "group_level":102
                                    }
                                ]
                            },
                            "apply_date":"2021-08-24 16:31:59",
                            "status":3
                        }
                    ]
                },
                "page":96
            },
            "state":200,
            "message":"ok"
        }
    }
}

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>

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

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

书旗内容文巢

alibaba.shuqi.original.backend.ognvaliauthor.getauditauthors (审核作者列表接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ