阿里大于 -

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
ling_yang_callback_event	LingYangCallbackEvent	必须			回调事件
└ tenant_id String 可选 25020813322855 租户id └ event_tag String 可选 summary 事件tag └ event_id String 可选 e0908cf1-8a3d-480c-bad6-5ec181650be2 事件id └ event_code String 可选 weworkRobot#weworkEvent 事件code event_body LingYangCallbackEventBody 必须 {} 事件内容 └ request_biz_id String 必须 169823891_117389214 天猫请求id └ callback_type String 必须 addContact 回调类型 └ phone String 可选 12345678901 手机号 └ wework_id String 可选 12345678901 企微id └ user_name String 可选 12345678901 用户昵称 └ user_id String 可选 12345678901 用户企微userid user_info UserInfo [] 可选 12345678901 用户信息，需求描述 └ info_name String 可选预算表单名称 └ info_key String 可选 budget 表单key └ info_value String 可选 1-3万表单值 user_stage UserStage 可选 12345678901 用户阶段 └ stage_name String 可选新客阶段名称 └ desc String 可选新客阶段描述 └ color String 可选 #F9DB07 阶段颜色 user_tag UserTag [] 可选 22401 用户标签 └ tag_name String 可选有效客资标签名称 └ tag_code String 可选 1132321 标签code └ desc String 可选客资是否有效标签描述 └ summary String 可选客户需要沙发跟单记录 └ success Boolean 可选 true 添加好友是否成功 └ error_messsage String 可选 null 错误信息

名称	类型	示例值	描述
crm_top_result	CrmTopResult		回调结果封装
└ success Boolean false 是否成功 └ model Boolean false 响应 └ msg_code String xxxxx 错误码 └ msg_info String xxxxx 错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrtCrmLydaasCallbackRequest req = new TmallNrtCrmLydaasCallbackRequest();
TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEvent obj1 = new TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEvent();
obj1.setTenantId("25020813322855");
obj1.setEventTag("summary");
obj1.setEventId("e0908cf1-8a3d-480c-bad6-5ec181650be2");
obj1.setEventCode("weworkRobot#weworkEvent");
TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEventBody obj2 = new TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEventBody();
obj2.setRequestBizId("169823891_117389214");
obj2.setCallbackType("addContact");
obj2.setPhone("12345678901");
obj2.setWeworkId("12345678901");
obj2.setUserName("12345678901");
obj2.setUserId("12345678901");
List<TmallNrtCrmLydaasCallbackRequest.UserInfo> list4 = new ArrayList<TmallNrtCrmLydaasCallbackRequest.UserInfo>();
TmallNrtCrmLydaasCallbackRequest.UserInfo obj5 = new TmallNrtCrmLydaasCallbackRequest.UserInfo();
list4.add(obj5);
obj5.setInfoName("预算");
obj5.setInfoKey("budget");
obj5.setInfoValue("1-3万");
obj2.setUserInfo(list4);
TmallNrtCrmLydaasCallbackRequest.UserStage obj6 = new TmallNrtCrmLydaasCallbackRequest.UserStage();
obj6.setStageName("新客");
obj6.setDesc("新客");
obj6.setColor("#F9DB07");
obj2.setUserStage(obj6);
List<TmallNrtCrmLydaasCallbackRequest.UserTag> list8 = new ArrayList<TmallNrtCrmLydaasCallbackRequest.UserTag>();
TmallNrtCrmLydaasCallbackRequest.UserTag obj9 = new TmallNrtCrmLydaasCallbackRequest.UserTag();
list8.add(obj9);
obj9.setTagName("有效客资");
obj9.setTagCode("1132321");
obj9.setDesc("客资是否有效");
obj2.setUserTag(list8);
obj2.setSummary("客户需要沙发");
obj2.setSuccess(true);
obj2.setErrorMesssage("null");
obj1.setEventBody(obj2);
req.setLingYangCallbackEvent(obj1);
TmallNrtCrmLydaasCallbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallNrtCrmLydaasCallbackRequest req = new TmallNrtCrmLydaasCallbackRequest();
TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEventDomain obj1 = new TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEventDomain();
obj1.TenantId = "25020813322855";
obj1.EventTag = "summary";
obj1.EventId = "e0908cf1-8a3d-480c-bad6-5ec181650be2";
obj1.EventCode = "weworkRobot#weworkEvent";
TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEventBodyDomain obj2 = new TmallNrtCrmLydaasCallbackRequest.LingYangCallbackEventBodyDomain();
obj2.RequestBizId = "169823891_117389214";
obj2.CallbackType = "addContact";
obj2.Phone = "12345678901";
obj2.WeworkId = "12345678901";
obj2.UserName = "12345678901";
obj2.UserId = "12345678901";
List<TmallNrtCrmLydaasCallbackRequest.UserInfoDomain> list4 = new List<TmallNrtCrmLydaasCallbackRequest.UserInfoDomain>();
TmallNrtCrmLydaasCallbackRequest.UserInfoDomain obj5 = new TmallNrtCrmLydaasCallbackRequest.UserInfoDomain();
list4.Add(obj5);
obj5.InfoName = "预算";
obj5.InfoKey = "budget";
obj5.InfoValue = "1-3万";
obj2.UserInfo= list4;
TmallNrtCrmLydaasCallbackRequest.UserStageDomain obj6 = new TmallNrtCrmLydaasCallbackRequest.UserStageDomain();
obj6.StageName = "新客";
obj6.Desc = "新客";
obj6.Color = "#F9DB07";
obj2.UserStage= obj6;
List<TmallNrtCrmLydaasCallbackRequest.UserTagDomain> list8 = new List<TmallNrtCrmLydaasCallbackRequest.UserTagDomain>();
TmallNrtCrmLydaasCallbackRequest.UserTagDomain obj9 = new TmallNrtCrmLydaasCallbackRequest.UserTagDomain();
list8.Add(obj9);
obj9.TagName = "有效客资";
obj9.TagCode = "1132321";
obj9.Desc = "客资是否有效";
obj2.UserTag= list8;
obj2.Summary = "客户需要沙发";
obj2.Success = true;
obj2.ErrorMesssage = "null";
obj1.EventBody= obj2;
req.LingYangCallbackEvent_ = obj1;
TmallNrtCrmLydaasCallbackResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallNrtCrmLydaasCallbackRequest;
$ling_yang_callback_event = new LingYangCallbackEvent;
$ling_yang_callback_event->tenant_id="25020813322855";
$ling_yang_callback_event->event_tag="summary";
$ling_yang_callback_event->event_id="e0908cf1-8a3d-480c-bad6-5ec181650be2";
$ling_yang_callback_event->event_code="weworkRobot#weworkEvent";
$event_body = new LingYangCallbackEventBody;
$event_body->request_biz_id="169823891_117389214";
$event_body->callback_type="addContact";
$event_body->phone="12345678901";
$event_body->wework_id="12345678901";
$event_body->user_name="12345678901";
$event_body->user_id="12345678901";
$user_info = new UserInfo;
$user_info->info_name="预算";
$user_info->info_key="budget";
$user_info->info_value="1-3万";
$event_body->user_info = $user_info;
$user_stage = new UserStage;
$user_stage->stage_name="新客";
$user_stage->desc="新客";
$user_stage->color="#F9DB07";
$event_body->user_stage = $user_stage;
$user_tag = new UserTag;
$user_tag->tag_name="有效客资";
$user_tag->tag_code="1132321";
$user_tag->desc="客资是否有效";
$event_body->user_tag = $user_tag;
$event_body->summary="客户需要沙发";
$event_body->success="true";
$event_body->error_messsage="null";
$ling_yang_callback_event->event_body = $event_body;
$req->setLingYangCallbackEvent(json_encode($ling_yang_callback_event));
$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=tmall.nrt.crm.lydaas.callback' \
-d 'partner_id=apidoc' \
-d 'sign=76E5207AB4A8E09D8B7B2947C64BEEF9' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-06-09+08%3A49%3A59' \
-d 'v=2.0' \
-d 'ling_yang_callback_event=null'

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

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

req.ling_yang_callback_event=""
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,"tmall.nrt.crm.lydaas.callback");
add_param(pRequest,"ling_yang_callback_event","数据结构JSON示例");
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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('tmall.nrt.crm.lydaas.callback', {
	'ling_yang_callback_event':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_nrt_crm_lydaas_callback_response>
    <crm_top_result>
        <success>false</success>
        <model>false</model>
        <msg_code>xxxxx</msg_code>
        <msg_info>xxxxx</msg_info>
    </crm_top_result>
</tmall_nrt_crm_lydaas_callback_response>

{
    "tmall_nrt_crm_lydaas_callback_response":{
        "crm_top_result":{
            "success":false,
            "model":false,
            "msg_code":"xxxxx",
            "msg_info":"xxxxx"
        }
    }
}

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下载

新零售开放API

tmall.nrt.crm.lydaas.callback (羚羊事件回调)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ