IconCreated with Sketch.

YAPI 接口文档

YApi
  • 公共分类(外部API)
    • 原查询客户列表
    • 原查询客户列表全部(不分页)
    • 查询租户关联企业列表
    • 查询租户关联企业列表(内部SDK)
  • 页面接口(所有接口作废)
    • 关联企业-受邀并新增编辑关联企业
    • 关联企业-受邀验证
    • 新增关联企业
    • 编辑关联企业
    • 邀请关联企业
  • 客户关联
    • 创建客户
    • 删除客户
    • 启用/禁用客户
    • 更新客户
    • 获取客户列表
    • 获取客户详情
    • 获取联系人电话号码
  • 执行公司关联
    • 创建执行公司_copy
    • 删除执行公司_copy
    • 启用/禁用执行公司_copy
    • 更新执行公司_copy
    • 获取执行公司列表_copy
    • 获取执行公司详情_copy
    • 获取联系人电话号码_copy
  • 供应商关联
    • 创建供应商_copy
    • 删除供应商_copy
    • 启用/禁用供应商_copy
    • 更新供应商_copy
    • 获取供应商列表_copy
    • 获取供应商详情_copy
    • 获取联系人电话号码_copy
  • 通用邀请流程
    • 获取邀请协议
    • 签发邀请码
    • 获取邀请信息(已邀请)
    • 作废邀请码
    • 获取受邀帮助信息
    • 输入邀请码
    • 确认邀请协议
    • 编辑主数据
    • 查询主数据
  • 总线
    • 关联公司,code修改通知

TDM

公共分类(外部API)

原查询客户列表

基本信息

Path: /api/executor/v1/custApi/list

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

名称类型是否必须默认值备注其他信息
custNameOrCodestring非必须名称或编码
unifiedCodestring非必须社会信用统一编码
addressstring非必须地址
pageSizenumber非必须每页大小
pageNumnumber非必须页数

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnull非必须
├─ custCodestring非必须客户编码
├─ custNamestring非必须客户名称
├─ unifiedCodestring非必须社会信用统一编码
├─ addressstring非必须地址
├─ statusnumber非必须状态
traceIdstring非必须
totalnumber非必须

原查询客户列表全部(不分页)

基本信息

Path: /api/executor/v1/custApi/listAll

Method: GET

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
tenCode 否 租户编码

Body

名称类型是否必须默认值备注其他信息
custNameOrCodestring非必须名称或编码
unifiedCodestring非必须社会信用统一编码
addressstring非必须地址
pageSizenumber非必须每页大小
pageNumnumber非必须页数

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnull非必须
├─ custCodestring非必须客户编码
├─ custNamestring非必须客户名称
├─ unifiedCodestring非必须社会信用统一编码
├─ addressstring非必须地址
├─ statusnumber非必须状态
traceIdstring非必须
totalnumber非必须

查询租户关联企业列表

基本信息

Path: /api/tdm/v1/affiliates/list

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
page 否 分页
size 否 分页

Body

名称类型是否必须默认值备注其他信息
kindstring非必须关联类型, cusomer(客户),executor(执行公司),provider(供应商)
codestring非必须自定义code
namestring非必须自定义name
rightCodestring非必须系统内部编码
tenantCodestring非必须租户唯一编码
statusboolean非必须状态:true, 有效 false,禁用 null: 不限定
bindingboolean非必须是否完成邀请绑定
caNamestring非必须企业统一认证名称
caCodestring非必须企业统一认证编码

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnumber必须id
├─ kindstring必须类别
├─ codestring必须编码
├─ namestring必须名称
├─ caCodenull必须社会统一信用代码
├─ caNamenull必须企业名称
├─ rightCodestring,null必须统一编码
├─ tenantCodestring必须租户编码
traceIdstring非必须
totalnumber非必须

查询租户关联企业列表(内部SDK)

基本信息

Path: /sdk/v1/affiliates/list

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
page 否 分页
size 否 分页
tenantCode 是 租户编码

Body

名称类型是否必须默认值备注其他信息
kindstring非必须关联类型, cusomer(客户),executor(执行公司),provider(供应商)
codestring非必须自定义code
namestring非必须自定义name
rightCodestring非必须系统内部编码
tenantCodestring非必须租户唯一编码
statusboolean非必须状态:true, 有效 false,禁用 null: 不限定

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnumber必须id
├─ kindstring必须类别
├─ codestring必须编码
├─ namestring必须名称
├─ caCodenull必须社会统一信用代码
├─ caNamenull必须企业名称
├─ rightCodestring,null必须统一编码
├─ tenantCodestring必须租户编码
traceIdstring非必须
totalnumber非必须

页面接口(所有接口作废)

关联企业-受邀并新增编辑关联企业

基本信息

Path: /api/tdm/v1/affiliates/accept/invite

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
code 是 邀请码 邀请码
entrance 是 入口 入口,customer executor provider

Body

名称类型是否必须默认值备注其他信息
editIdnumber非必须新增时,editId 为null,编辑时,editId有值
kindstring必须类别
providerobject非必须
├─ isActiveboolean非必须是否激活
├─ codestring非必须编码,新增时传值
├─ namestring非必须名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ phonestring非必须联系电话
├─ otherContactobject []非必须其他联系人

item 类型: object

├─ contactstring必须
├─ phonestring必须
customerstring非必须客户
executorstring非必须执行公司

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

关联企业-受邀验证

基本信息

Path: /api/tdm/v1/affiliates/accept/invite

Method: GET

接口描述:

l 发邀租户在受邀租户的本列表(【客户】、【供应商】或【执行公司】)中不存在,且没有绑定关系。页面为新增关联企业
l 发邀租户在受邀租户的本列表(【客户】、【供应商】或【执行公司】)中存在,且没有完成绑定邀请。完成输入编码时,展示名称、地址等信息,可以直接修改。绑定到本条数据。
l 发邀租户在受邀租户的本列表(【客户】、【供应商】或【执行公司】)中存在,已经完成绑定邀请。直接展示名称、地址等信息,可以直接修改。

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
code 是 邀请码 邀请码
entrance 是 入口 入口,customer executor provider

Body

名称类型是否必须默认值备注其他信息

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ kindstring非必须类别
├─ kindNamenull非必须
├─ caNamenull非必须企业实名
├─ caCodenull非必须企业统一信用代码
├─ inviteTenantKindstring必须发邀租户类别
├─ protocolobject []必须协议列表

item 类型: object

├─ namestring必须协议名称
├─ urlstring必须协议地址
├─ customernull非必须客户
├─ executornull非必须执行公司
├─ providerobject非必须供应商
├─ isActiveboolean非必须是否激活
├─ codestring非必须编码
├─ namestring非必须名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ phonestring非必须联系电话
├─ otherContactobject []非必须其他联系人

item 类型: object

├─ contactstring必须
├─ phonestring必须
traceIdstring非必须

新增关联企业

基本信息

Path: /api/tdm/v1/affiliates/create

Method: POST

接口描述:

根据 kind 内容,对应的 customer、executor、provider部分有值。

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

名称类型是否必须默认值备注其他信息
kindstring非必须类别
customerobject非必须客户
├─ codestring非必须编码
├─ namestring非必须名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ phonestring非必须联系电话
├─ otherContactobject []非必须其他联系人

item 类型: object

├─ contactstring必须联系人
├─ phonestring必须联系电话
executorstring必须执行公司,结构同客户
providerstring必须供应商,结构同客户

返回数据

名称类型是否必须默认值备注其他信息

编辑关联企业

基本信息

Path: /api/tdm/v1/affiliates/{id}/edit

Method: POST

接口描述:

根据 kind 内容,对应的 customer、executor、provider部分有值。
ohterContent 是否修改都需要传入参数,
修改条目只传 phone 一个值,phoneText、phoneSalt为null,
其他不修改的条目传拉取到的 phone、phoneText、phoneSalt

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

路径参数

参数名称 示例 备注
id

Body

名称类型是否必须默认值备注其他信息
kindstring非必须类别
customerobject非必须客户
├─ isActiveboolean非必须是否激活
├─ namestring非必须名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ phonestring非必须联系电话
├─ otherContactobject []非必须其他联系人

item 类型: object

├─ contactstring必须联系人
├─ phonestring必须联系电话
├─ phoneTextstring必须加密电话
├─ phoneSaltstring必须加密方式
executorstring必须执行公司,结构同客户
providerstring必须供应商,结构同客户

返回数据

名称类型是否必须默认值备注其他信息

邀请关联企业

基本信息

Path: /api/tdm/v1/affiliates/{id}/invite

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

路径参数

参数名称 示例 备注
id

Body

名称类型是否必须默认值备注其他信息

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ existInviteboolean非必须是否已有邀请
├─ codestring非必须邀请码
├─ inviteOperationstring非必须邀请方法
traceIdstring非必须

客户关联

创建客户

基本信息

Path: /api/tdm/v1/affiliate/customer/create

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

名称类型是否必须默认值备注其他信息
codestring必须客户编码
namestring必须客户名称
addressstring非必须地址
contactstring非必须联系人
contactPhoneShowstring非必须联系人手机,带"*"不更新
extendProp2string非必须扩展属性,待定

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须客户ID
├─ kindstring非必须类型
├─ codestring非必须客户编码
├─ namestring非必须客户名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须企业认证名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须联系电话密钥
├─ contactPhoneShowstring非必须联系电话显示
├─ rightCodestring非必须系统编码
├─ extendProp2null非必须扩展属性
traceIdstring非必须

删除客户

基本信息

Path: /api/tdm/v1/affiliate/customer/delete

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

Query

参数名称 是否必须 示例 备注
id 是 18

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

启用/禁用客户

基本信息

Path: /api/tdm/v1/affiliate/customer/status

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

Query

参数名称 是否必须 示例 备注
status 是 true
id 是 24

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

更新客户

基本信息

Path: /api/tdm/v1/affiliate/customer/update

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
id 是 24

Body

名称类型是否必须默认值备注其他信息
codestring非必须客户编码
namestring非必须客户名称
addressstring非必须地址
contactstring非必须联系人
contactPhoneShowstring非必须联系人手机
extendProp2string非必须扩展属性

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须客户ID
├─ kindstring非必须类型
├─ codestring非必须客户编码
├─ namestring非必须客户名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须公司认证名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须联系人电话
├─ contactPhoneShowstring非必须联系人电话显示
├─ rightCodestring非必须系统编码
├─ extendProp2null非必须扩展属性
traceIdstring非必须

获取客户列表

基本信息

Path: /api/tdm/v1/affiliate/customer/list

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
search 否 条件
page 否 0, 表示首页
size 否

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnumber必须企业关联ID
├─ kindstring必须企业类型
├─ codestring必须企业编码
├─ namestring必须企业名称
├─ caCodenull必须社会统一编码
├─ caNamenull必须企业认证名称
├─ addressstring必须地址
├─ contactstring必须联系人
├─ contactPhonestring必须获取手机号的密钥
├─ contactPhoneShowstring必须显示使用的手机号
├─ rightCodestring必须系统统一编码
├─ status1boolean必须状态
├─ bindingstring必须绑定状态, 未邀请,邀请中,已绑定
traceIdstring非必须
totalnumber非必须

获取客户详情

基本信息

Path: /api/tdm/v1/affiliate/customer/detail

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 是

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须企业ID
├─ kindstring非必须类型
├─ codestring非必须编码
├─ namestring非必须名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须企业名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须手机号密钥
├─ contactPhoneShowstring非必须显示的手机号
├─ rightCodestring非必须系统编码
├─ extendProp2object非必须扩展属性
traceIdstring非必须

获取联系人电话号码

基本信息

Path: /api/tdm/v1/affiliate/customer/contact/phone

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 是 18
phone 是 1901013005439286935

返回数据

名称类型是否必须默认值备注其他信息

执行公司关联

创建执行公司_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/create

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

名称类型是否必须默认值备注其他信息
codestring必须客户编码
namestring必须客户名称
addressstring非必须地址
contactstring非必须联系人
contactPhoneShowstring非必须联系人手机,带"*"不更新
extendProp2string非必须扩展属性,待定

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须客户ID
├─ kindstring非必须类型
├─ codestring非必须客户编码
├─ namestring非必须客户名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须企业认证名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须联系电话密钥
├─ contactPhoneShowstring非必须联系电话显示
├─ rightCodestring非必须系统编码
├─ extendProp2null非必须扩展属性
traceIdstring非必须

删除执行公司_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/delete

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

Query

参数名称 是否必须 示例 备注
id 是 18

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

启用/禁用执行公司_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/status

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

Query

参数名称 是否必须 示例 备注
status 是 true
id 是 24

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

更新执行公司_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/update

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
id 是 24

Body

名称类型是否必须默认值备注其他信息
codestring非必须客户编码
namestring非必须客户名称
addressstring非必须地址
contactstring非必须联系人
contactPhoneShowstring非必须联系人手机
extendProp2string非必须扩展属性

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须客户ID
├─ kindstring非必须类型
├─ codestring非必须客户编码
├─ namestring非必须客户名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须公司认证名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须联系人电话
├─ contactPhoneShowstring非必须联系人电话显示
├─ rightCodestring非必须系统编码
├─ extendProp2null非必须扩展属性
traceIdstring非必须

获取执行公司列表_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/list

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
search 否 条件
page 是 0, 表示首页
size 是

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnumber必须企业关联ID
├─ kindstring必须企业类型
├─ codestring必须企业编码
├─ namestring必须企业名称
├─ caCodenull必须社会统一编码
├─ caNamenull必须企业认证名称
├─ addressstring必须地址
├─ contactstring必须联系人
├─ contactPhonestring必须获取手机号的密钥
├─ contactPhoneShowstring必须显示使用的手机号
├─ rightCodestring必须系统统一编码
├─ status1boolean必须状态
├─ bindingstring必须绑定状态, 未邀请,邀请中,已绑定
traceIdstring非必须
totalnumber非必须

获取执行公司详情_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/detail

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 是

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须企业ID
├─ kindstring非必须类型
├─ codestring非必须编码
├─ namestring非必须名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须企业名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须手机号密钥
├─ contactPhoneShowstring非必须显示的手机号
├─ rightCodestring非必须系统编码
├─ extendProp2object非必须扩展属性
traceIdstring非必须

获取联系人电话号码_copy

基本信息

Path: /api/tdm/v1/affiliate/executor/contact/phone

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 是 18
phone 是 1901013005439286935

返回数据

名称类型是否必须默认值备注其他信息

供应商关联

创建供应商_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/create

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

名称类型是否必须默认值备注其他信息
codestring必须客户编码
namestring必须客户名称
addressstring非必须地址
contactstring非必须联系人
contactPhoneShowstring非必须联系人手机,带"*"不更新
extendProp2string非必须扩展属性,待定

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须客户ID
├─ kindstring非必须类型
├─ codestring非必须客户编码
├─ namestring非必须客户名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须企业认证名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须联系电话密钥
├─ contactPhoneShowstring非必须联系电话显示
├─ rightCodestring非必须系统编码
├─ extendProp2null非必须扩展属性
traceIdstring非必须

删除供应商_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/delete

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

Query

参数名称 是否必须 示例 备注
id 是 18

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

启用/禁用供应商_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/status

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

Query

参数名称 是否必须 示例 备注
status 是 true
id 是 24

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

更新供应商_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/update

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Query

参数名称 是否必须 示例 备注
id 是 24

Body

名称类型是否必须默认值备注其他信息
codestring非必须客户编码
namestring非必须客户名称
addressstring非必须地址
contactstring非必须联系人
contactPhoneShowstring非必须联系人手机
extendProp2string非必须扩展属性

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须客户ID
├─ kindstring非必须类型
├─ codestring非必须客户编码
├─ namestring非必须客户名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须公司认证名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须联系人电话
├─ contactPhoneShowstring非必须联系人电话显示
├─ rightCodestring非必须系统编码
├─ extendProp2null非必须扩展属性
traceIdstring非必须

获取供应商列表_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/list

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
search 否 条件
page 是 0, 表示首页
size 是

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject []非必须

item 类型: object

├─ idnumber必须企业关联ID
├─ kindstring必须企业类型
├─ codestring必须企业编码
├─ namestring必须企业名称
├─ caCodenull必须社会统一编码
├─ caNamenull必须企业认证名称
├─ addressstring必须地址
├─ contactstring必须联系人
├─ contactPhonestring必须获取手机号的密钥
├─ contactPhoneShowstring必须显示使用的手机号
├─ rightCodestring必须系统统一编码
├─ status1boolean必须状态
├─ bindingstring必须绑定状态, 未邀请,邀请中,已绑定
traceIdstring非必须
totalnumber非必须

获取供应商详情_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/detail

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 是

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须企业ID
├─ kindstring非必须类型
├─ codestring非必须编码
├─ namestring非必须名称
├─ caCodenull非必须社会统一编码
├─ caNamenull非必须企业名称
├─ addressstring非必须地址
├─ contactstring非必须联系人
├─ contactPhonestring非必须手机号密钥
├─ contactPhoneShowstring非必须显示的手机号
├─ rightCodestring非必须系统编码
├─ extendProp2object非必须扩展属性
traceIdstring非必须

获取联系人电话号码_copy

基本信息

Path: /api/tdm/v1/affiliate/provider/contact/phone

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 是 18
phone 是 1901013005439286935

返回数据

名称类型是否必须默认值备注其他信息

通用邀请流程

获取邀请协议

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/sender/protocol

Method: GET

接口描述:

请求参数

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
id 是 11 主数据ID

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ templateIdnumber非必须模板ID
├─ templateVersionnumber非必须模板版本
├─ contentstring非必须提示内容
├─ protocolsobject []非必须

item 类型: object

├─ codestring必须协议编码
├─ versionstring必须协议版本
├─ namestring必须协议名称
├─ uristring必须协议地址(外链打开)
traceIdstring非必须

签发邀请码

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/sender/code/create

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
id 是 11 主数据ID
templateId 是 2 邀请模板
templateVersion 是 2 邀请模板版本

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ codestring非必须邀请码
├─ contentstring非必须提示内容
├─ expiredAtstring非必须邀请码过期时间
traceIdstring非必须

获取邀请信息(已邀请)

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/sender/code/info

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
id 是 11 主数据ID

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ codestring非必须邀请码
├─ contentstring非必须提示内容
├─ expiredAtstring非必须邀请码过期时间
traceIdstring非必须

作废邀请码

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/sender/code/invalid

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
id 是 11 主数据ID

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
traceIdstring非必须

获取受邀帮助信息

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/accept/start/help

Method: GET

接口描述:

请求参数

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ contentstring非必须提示内容
traceIdstring非必须

输入邀请码

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/accept/code/verify

Method: GET

接口描述:

请求参数

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
code 是 邀请码

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ contentstring非必须提示内容
├─ protocolsobject []非必须协议

item 类型: object

├─ codestring必须协议编码
├─ versionstring必须协议版本
├─ namestring必须协议名称
├─ uristring必须协议地址
traceIdstring非必须

确认邀请协议

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/accept/protocol/confirm

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded 是

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
code 是 邀请码

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ editCodestring必须修改和编辑码
├─ caCodestring必须发邀企业社会统一编码
├─ caNamestring必须发邀企业名称
traceIdstring非必须

编辑主数据

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/accept/data/edit

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
code 是 编辑码

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ contentstring非必须提示的内容
traceIdstring非必须

查询主数据

基本信息

Path: /api/tdm/v1/affiliate/{kind}/invite/accept/data

Method: GET

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

路径参数

参数名称 示例 备注
kind customer customer, executor, provider ...

Query

参数名称 是否必须 示例 备注
code 是 主数据编码

返回数据

名称类型是否必须默认值备注其他信息
successboolean非必须
dataobject非必须
├─ idnumber非必须主数据ID
├─ kindstring非必须类型,忽略
├─ codestring必须主数据编码
├─ namestring必须主数据名称
├─ caCodenull非必须认证信息,忽略
├─ caNamenull非必须认证信息,忽略
├─ addressnull非必须地址
├─ contactnull非必须联系人
├─ contactPhonenull非必须联系人电话密钥
├─ contactPhoneShownull非必须联系人电话显示
├─ rightCodestring非必须系统唯一编码
├─ extendProp2null非必须扩展属性
├─ existboolean非必须数据是否存在
├─ bindableboolean非必须数据能否绑定
traceIdstring非必须

总线

关联公司,code修改通知

基本信息

Path: /com_myfmes_mdm.tdm-affiliate-data-change

Method: POST

接口描述:

总线主题:com_myfmes_mdm.tdm-affiliate-data-change

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 是

Body

名称类型是否必须默认值备注其他信息
idnumber非必须数据主键
rightCodestring非必须系统统一编码
sidstring非必须sessionId
sourceobject非必须
├─ codestring非必须
├─ namestring非必须
targetobject非必须
├─ codestring非必须
├─ namestring非必须
tenantCodestring非必须租户Code
traceIdstring非必须追踪ID
kindstring非必须类型,customer, provider, executor

返回数据

名称类型是否必须默认值备注其他信息

Build by YMFE.