alisoft.udb.getDomainLoginId API功能描述

根据软件互联平台的用户ID，获取用户的阿里巴巴中文站（或淘宝）帐号。

getDomainLoginId API调用级别

apiType=1，需要签名校验(不需用户绑定)

getDomainLoginId API调用参数

系统级参数

名称

类型

是否必须

描述

sip_appkey

String

必须

ISV应用的appkey为软件互联平台分配给ISV应用的唯一编号。

sip_apiname

String

必须

服务名。

sip_timestamp

String

必须

服务请求时间戳(yyyy-mm-dd hh:mi:ss)。

sip_sign

String

必须

请求签名（包括了对前面三个必选参数和所有业务参数按签名规则做签名）。

sip_sessionid

String

可选

在ISV应用中用户会话唯一标识。

sip_format

String

可选

规定返回值的类型。支持两种格式json与xml。默认为xml数据格式。

应用级参数

名称

类型

是否必须

描述

domainid

String

必须

网站标识：用“1”代表中文站，“3”代表淘宝。

userid

String

必须

软件互联平台用户ID

正常返回格式

XML数据格式

<?xml version="1.0" encoding="utf-8" ?>
<StringResult>
<code>0</code>
<result>test</result>
</StringResult>

返回值

返回值描述

返回值说明

应用的订购者

订购者就是订购该服务的人

应用的使用者

使用者就是使用该服务的人，只有被订阅者授权(邀请)以后才可以使用该服务

-1

尚未订购该应用

表示尚未订购该应用的用户

-2

非法用户

表示非法用户(没有正常登录软件互联平台，或者URL已过期失效)

异常返回格式

XML数据格式

<?xml version="1.0" encoding="utf-8" ?>
<error>error_message</error>

错误码

错误描述

原因及处理方法

1001

签名无效

原因：参数的sip_appkey、sip_appsecret错误或者不匹配。
解决：检查参数正确性，或到ASSP中检查或重新申请。

1002

请求已过期

原因：访问时间过期。
解决：检查sip_timestamp参数，检查网络延迟。

1003

用户绑定失败

原因：在调用此API时

1004

需要绑定用户

原因：在调用此API时，ISP要求用户验证并绑定(登录)。在请求中没有带sip_usertoken参数，无法进行绑定
解决：1、引导用户登录，处理流程见：5.4.5.4 用户身份验证
2、下次调用时，带上用户最新的sip_usertoken参数

1005

需要提供appid

原因：缺少sip_appkey参数

1006

需要提供服务名

原因：缺少sip_apiname参数

1007

需要提供签名

原因：缺少sip_sign参数

1008

需要提供时间戳

原因：缺少sip_timestamp参数

1009

用户认证失败

原因：访问时间过期

1010

无权访问服务

原因：此服务API没有被订购、订购过期、账户余额不足等。
解决：到ISV Portal订购此API。

1011

服务不存在

原因：ISP无此服务

0000

未知异常

原因：不确定原因导演API调用失败。如：
1.SIP访问ISP时网络故障
2.ISP提供的API因故停用
3.其它未知原因

9999

调用成功

范例

alisoft.udb.getDomainLoginId接口调用实例

http://sipdev.alisoft.com/sip/rest?sip_appkey=a001&sip_apiname=alisoft.udb.getDomainLoginId&sip_timestamp=2008-03-11 20:00:00&sip_sign=23ed99f1a0a1eac5f3787d522afde1c4&userid=111&domainid=1

历史版本

版本号

说明

1.0

初始版本