更新时间：2024-05-22 GMT+08:00
企业同步
接口说明
- 买家购买联营SaaS商品后，登录到华为云买家中心控制台，将应用与企业绑定时，云商店调用该接口请求商家同步该企业的租户信息，商家接口需要执行租户同步，保存租户信息，并返回通知云商店。
- 针对企业同步场景接口调用失败的情况，由买家选择是否重试，并用短信或邮件的形式通知商家接口调用失败。
- 商家的服务器在处理接口请求时，需要做好幂等性处理。
对于同一个实例，相同的租户要支持多次请求新增，或者删除，多次新增不应产生新的数据，且需要返回成功，如果是删除，多次删除也需要返回成功，不能因已删除返回失败，删除时不需要校验(创建实例)接口产生的实例是否存在。
租户同步流程如下图所示：
请求方法：POST
接口URL：生产地址+固定子路径，其中固定子路径为/produceAPI/v2/tenantSync；
接口示例：生产地址为https://example.isv.com，则接口URL为https://example.isv.com/produceAPI/v2/tenantSync
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-新增 2-修改（仅限租户名称、域名） |
|
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/v2/tenantSync
Content-Type: application/json
x-sign:11C4CD6279191DE931DEF5C51531DFFA9D37969F4E356B8A3A6D8DE4FB357A48
x-timestamp:1680508066618
x-nonce:50D83FDECAED6CCD8EF597F2A577950527928BA287D04E6036E92B2806FD17DA
{"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
Content-Type: application/json
{
" resultCode": "000000",
" resultMsg": "Success"
}
父主题： 联营kit接口描述
