部门增量同步-j9九游会登录
接口说明
- 管理员被授权管理某企业后,在华为云买家中心控制台登录,对管理的企业执行新建、编辑、删除部门操作时,云商店调用该接口,请求商家同步该企业的组织增量变更;商家接口需要执行增量组织信息同步,保存信息,并返回通知云商店。
- 商家的服务器在处理接口请求时,需要做好幂等性处理。
对于同一个实例,相同的租户,相同的orgcode,要支持多次请求新增,或者删除,多次新增不应产生新的数据,且需要返回成功,如果是删除,多次删除也需要返回成功,不能因已删除返回失败,删除时不需要校验(创建实例)接口产生的实例是否存在。
部门增量同步 流程如下图所示:

请求方法:post
接口url:生产地址 固定子路径,其中固定子路径为/produceapi/v2/singleorgsync;
接口示例:生产地址为https://example.isv.com,则接口url为https://example.isv.com/produceapi/v2/singleorgsync
body请求参数
|
参数 |
必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instanceid |
m |
string(64) |
说明:
卖家申请应用凭证的时候传空,买家必传。 |
|
tenantid |
m |
string(64) |
租户id,与租户的同步信息保持一致 |
|
orgcode |
m |
string(64) |
部门代码租户自定义,租户内唯一 |
|
orgname |
m |
vachar(128) |
部门名称所在层级唯一,允许租户更新名称 |
|
parentcode |
o |
string(64) |
上级部门的orgcode,如果是顶层部门,这个值为空,其他场景不能为空,允许租户更新当前部门归属的上层部门 |
|
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/singleorgsync
content-type: application/json
x-sign: 11c4cd6279191de931def5c51531dffa9d37969f4e356b8a3a6d8de4fb357a48
x-timestamp: 1680508066618
x-nonce:50d83fdecaed6ccd8ef597f2a577950527928ba287d04e6036e92b2806fd17da
{"instanceid": "hua********23456","instanceid": "hua********23456","tenantid": "68cbc********0d92f36422fa0e","orgcode": "10000","orgname": "开发部","parentcode": "","flag": 1,"testflag": 0,"timestamp": "20220413093539534"}
响应示例:
http/1.1 200 ok
content-type: application/json
{
" resultcode": "000000",
" resultmsg": "success"
}
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨