租户信息同步接口-j9九游会登录
接口说明
- 买家购买联营saas商品后,在买家中心登录,将应用与企业绑定时,云商店调用该接口请求商家同步该企业的租户信息,商家接口需要执行租户同步,保存租户信息,并返回通知云商店。
- 针对租户同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知商家接口调用失败。
- 商家的服务器在处理接口请求时,需要做好幂等性处理。
对于同一个实例,相同的租户要支持多次请求新增,或者删除,多次新增不应产生新的数据,且需要返回成功,如果是删除,多次删除也需要返回成功,不能因已删除返回失败,删除时不需要校验(新购商品)接口产生的实例是否存在。
租户同步流程如下图所示:

请求方法:post
接口url:生产地址 固定子路径,其中固定子路径为/produceapi/tenantsync;
接口示例:生产地址为https://example.isv.com,则接口url为https://example.isv.com/produceapi/tenantsync
headers请参数
|
参数 |
必选 |
参数类型 |
描述 |
|---|---|---|---|
|
authtoken |
m |
string(255) |
签名信息,请参考auth token取值说明。 |
body参数
|
参数 |
必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instanceid |
m |
string(64) |
说明:
实例id,卖家申请应用凭证的时候传空,买家正式订单必传。 |
|
orderid |
m |
string(64) |
说明:
买家的订单号,卖家申请应用凭证的时候传空,买家正式订单必传。 |
|
tenantid |
m |
string(64) |
租户id |
|
tenantcode |
m |
string(64) |
租户标识,用来识别最终用户的登录指向买家对应的域名 |
|
name |
m |
string(255) |
租户名称,买家企业的名称 |
|
domainname |
m |
string(255) |
域名,是认证中心返回的统一域名地址 |
|
flag |
m |
integer(2) |
0-删除 1-新增 |
|
testflag |
m |
integer(2) |
0-生产正式数据 1-调测数据 |
|
timestamp |
m |
string |
默认时区东8区,时间戳,时间格式:20220420114117642 |
响应参数
|
参数 |
必选 |
参数类型 |
描述 |
|---|---|---|---|
|
resultcode |
m |
string(6) |
响应码,具体请参见调用结果码说明。 |
|
resultmsg |
o |
string(255) |
响应信息 |
示例:
post https://example.isv.com/produceapi/tenantsync */produceapi/tenantsync为固定值/*
connection: keep-alive
content-type: application/json
authtoken: "stb****************hvordsmyf2ubt271qdr6wdavltlrb”
host: example.isv.com
user-agent: apache-httpclient/4.5.3 (java/1.8.0_191)
{
"instanceid": "huaiweitest123456",
"orderid": "cs1906666666abcde",
"tenantid": "68cbc86****************880d92f36422fa0e",
"tenantcode": "huawei",
"name": "huaiweitest",
"domainname": "https://example.tenantaccount.com",
"flag": 1,
"testflag": 0,
"timestamp": "20220413093539534",
}
http/1.1 200 ok
body-sign: sign_type="hmac-sha256", signature= "******"
content-type: application/json
{
" resultcode": "000000",
" resultmsg": "success"
}
http body签名:
body-sign: sign_type="hmac-sha256", signature= "******" ,详情参考《http body签名》。
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨