j9九游会登录/ 云商店/ / / / / / / 租户应用信息同步接口
更新时间:2024-06-11 gmt 08:00

租户应用信息同步接口-j9九游会登录

接口说明

  • 买家购买联营saas类应用后,在买家中心登录,将应用与企业绑定时,云商店调用该接口请求商家同步该企业应用的认证信息,商家接口需要执行应用同步,保存应用信息,并返回通知云商店。
  • 针对应用同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知isv商家接口调用失败。
  • 商家的服务器在处理接口请求时,需要做好幂等性处理。

    对于同一个实例,相同的租户,相同的应用,要支持多次请求新增,或者删除,多次新增不应产生新的数据,且需要返回成功,如果是删除,多次删除也需要返回成功,不能因已删除返回失败,删除时不需要校验(新购商品)接口产生的实例是否存在

应用同步流程如下图所示:

请求方法:post

接口url:生产地址 固定子路径,其中固定子路径为/produceapi/applicationsync;

接口示例:生产地址为https://example.isv.com,则接口url为https://example.isv.com/produceapi/applicationsync

headers请参数

参数

必选

参数类型

描述

authtoken

m

string(255)

签名信息,请参考auth token取值说明

body参数

参数

必选

参数类型

描述

instanceid

m

string(64)

说明:

卖家申请应用凭证的时候传空,买家必传。

tenantid

m

string(64)

租户id, 与租户同步接口的租户id是一致的

appid

m

string(64)

应用的id,云商店应用凭证中的应用id

clientid

m

string(64)

客户端id,是认证中心统一返回的clientid

clientsecret

m

string

客户端secret,该参数传递时云商店将使用商家创建应用时提供的公钥进行rsa加密(密钥长度>=3072bit,填充方式oaep),商家服务器在接收到参数后需要用自己本地保存的私钥解密(公私钥对)

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/applicationsync 
connection: keep-alive
content-type: application/json
authtoken: "stbnyluhv***************bt271qdr6wdavltlrb”
host: example.isv.com
user-agent: apache-httpclient/4.5.3 (java/1.8.0_191)
{
 "instanceid": "huaiweitest123456", 
 "appid": "ksidjf1234456", 
 "tenantid": "68cbc8*********b880d92f36422fa0e", 
 "clientid": " bc20*******880d92f3", 
 "clientsecret":"dsdt*******ecdd#$^#" , 
 "flag": 1, 
 "testflag": 0, 
 "timestamp": "20220413093539534" ,
}
http/1.1 200 ok
body-sign: sign_type="hmac-sha256", signature= "xxxxxxxxxx"  
content-type: application/json
{
" resultcode": "000000",
" resultmsg": "success"
}

http body签名:

body-sign: sign_type="hmac-sha256", signature= "xxxxxxxxxxxxx" ,详情参考《http body签名》

相关文档

网站地图