组织部门信息同步(全量)-j9九游会登录
接口说明
- 买家购买联营saas应用后,在买家中心登录,将应用与企业绑定时,云商店调用该接口请求商家同步该企业全量的组织信息,商家接口需要执行全量组织信息同步,保存组织信息,并返回通知云商店。
- 商家的服务器在处理接口请求时,需要做好幂等性处理。
对于同一个实例,相同的租户,相同的orgcode,要支持多次请求,多次请求不应产生新的数据,且需要返回成功。
请求方法:post
接口url:生产地址 固定子路径,其中固定子路径为/produceapi/allorgsync;
接口示例:生产地址为https://example.isv.com,则接口url为https://example.isv.com/produceapi/allorgsync
headers请参数
|
参数 |
必选 |
参数类型 |
描述 |
|---|---|---|---|
|
authtoken |
m |
string(255) |
签名信息,请参考auth token取值说明。 |
body请求参数
|
参数 |
必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instanceid |
m |
string(64) |
说明:
卖家申请应用凭证的时候传空,买家必传。 |
|
tenantid |
m |
string(64) |
租户id |
|
orginfo |
m |
string |
组织内部门层级信息,包含部门代码、部门名称、上级部门code,json串,非树形结构 json串,例: [{\"orgcode\":\"00000001\", \"name\":\"产品部\",\"parentcode\":\"265789314\"},{\"orgcode\":\"00000002\", \"name\":\"测试部\",\"parentcode\":\"265789314\"}] |
|
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/allorgsync
connection: keep-alive
content-type: application/json
authtoken: "stbnyluh*********dr6wdavltlrb”
host: example.isv.com
user-agent: apache-httpclient/4.5.3 (java/1.8.0_191)
{
"instanceid": "hua******t123456",
"tenantid": "68cbc8******b880d92f36422fa0e",
"orginfo": "[{orgcode:\"00000001\", name:\"产品部\", parentcode:\"265789314\" },{orgcode:\"00000002\", name:\"测试部\", parentcode:\"265789314\" }]",
"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签名》。
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨