回调示例

  • 接口:相对应的主数据接口调用地址
  • Method:POST
  • 数据格式:JSON
  • 限流信息:100次每天和50次每小时
  • 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
  • 接口说明:主数据批量同步回调接口,仅对OPENAPI文档中主数据目录下接口路径以 batch 结尾的接口有效,url 为对方系统提供的接口回调地址
  • 其他补充信息:

示例代码

 String bizId = json.get("bizId").toString();
    ​//MD5后的字符串
    ​String s = MD5toString.MD5(bizId + salt);
    ​if (token.equals(s)){
       ​// 合法请求  todoif (json.getString("resCode").equals("200000")){
           ​//同步数据成功
       ​} else{
           ​//同步数据失败
       ​}
    ​} else {
       ​// 非法请求  todo
    ​}
    ​/**
    ​* 数据处理无异常时json格式示例(warnings可能没有)
    ​* {
    ​*     "resCode": 200000,
    ​*     "resMsg": "success",
    ​*     "bizId":"xxxxxx",
    ​*     "access_token": "e6f35d171d538bd312a755da5322e612",
    ​*     "data": {
    ​*         "created": "此次请求新建成功了1条数据",
    ​*         "dbErrors": [],
    ​*         "updated": "此次请求更新成功了1条数据",
    ​*         "warnings":{},
    ​*         "validatorErrors": {
    ​*             "10": [
    ​*                 "分公司编码1006001不存在"
    ​*             ]
    ​*         }
    ​*     }
    ​* }
    ​** 数据处理异常时json格式示例
    ​* {
    ​*     "resCode": 5000000,
    ​*     "resMsg": "服务器异常、请稍后再试",
    ​*     "bizId":"xxxxxx",
    ​*     "access_token": "e6f35d171d538bd312a755da5322e612",
    ​* }
    ​* */

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)

返回参数

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码
resMsg String 返回信息描述
created String 创建成功的条数
updated String 更新成功的条数
validatorErrors Array 字段强校验不合格的数据
dbErrors Array 数据持久化时出现错误的数据
warnings Array 字段弱校验不合格的数据,任会做同步处理

示例:

请求数据



返回数据

{
  "bizId": "d9346662-df40-456b-adbd-d2baf46ca770",
  "timestamp": 1586825055000,
  "url": "callback url",
  "data": [{
    "column1": "column1",
    "code": "TX005",
    "parent_code": "TX004",
    "branch_code": "D001",
    "department_code": "D01011-4",
    "description": "采购主管171的描述",
    "approval_level": 5,
    "position_name": "采购主管171",
    "enabled_flag": "Y"
  }]
}

results matching ""

    No results matching ""