C咖开放接口


同步经销商

1. 判断编码是否已存在,存在则执行修改逻辑,不存在则执行新增逻辑

2. 数量不能超过50条

请求信息

协议

HTTPS

请求方法

POST

请求路径

/trace/app/v1/open/org/dealer

请求头

Content-Type:application/json

请求参数

名称

是否必须

参数类型

参数说明

code String 编码
name String 名称
level Integer 经销商级别
parentType Long 父级类型:如果是顶级可为0
parentCode String 父级编码:如果是顶级可为空字符串
districtCode String 所在地编码
address String 详细地址
districtCodes String[] 销售区域代码
maxEmployees Integer 员工上限
remark String 备注
licensePath String 证照文件url地址
manager Object 经销商负责人信息 dealer Manager Object containing mobile and name attributes
├─ name name 负责人姓名
├─ cellphone name 负责人手机号
flag Integer 1:启用 0:禁用 -1:删除

传出参数

名称

参数类型

参数说明

code

int

错误码,200:成功,其它为失败

message

string

 

data

object

返回信息

 

请求示例

[
{
  "code": "dealer-001",
  "name": "经销商001",
  "level": 1,
  "parentCode": "",
  "parentType": 2,
  "districtCode": "230602007000",
  "address": "",
  "districtCodes": ["130000000000", "230000000000"],
  "maxEmployees": 0,
  "licensePath": "",
  "remark": "这是备注"
}
]

响应示例

{
    "code": 200,
    "message": "success",
    "data": null,
    "timestamp": 1769060123004,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}

异常示例

{
    "code": 20503092,
    "message": "不允许删除,因为已启用",
    "data": null,
    "timestamp": 1769138423026,
    "traceId": "4f685a72-7aa4-4a8f-813a-80df0e70938f",
    "exception": null,
    "meta": null,
    "ext": null
}


weizejun 2026年5月6日 14:33 收藏文档