渠道和分润管理服务

更新时间：2018-05-18 21:40:30

创建运营商与运营商的关系

定义描述

path 版本 描述 是否需要cloudToken
/cloud/linkbusiness/projectRelation/create 1.0.1 创建运营商与运营商的关系（运营商绑定下级运营商） 是

请求参数

参数 类型 必填 描述
projectId String 是 项目id
identityId String 是 项目拥有者的身份id
ratio BigDecimal 是 分润比例
childName String 是 下级运营商名称
childLoginName String 是 下级运营商登录名
childIdentityId String 是 下级运营商的身份id
childTenantId String 是 下级运营商的租户id

返回参数

参数 类型 描述
id Long id-返回创建运营商ID

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0",
        "iotToken": "token"
    },
    "params": {
        "projectId":"a1248WWgMq9jWEmE",
        "identityId":"5030al5c186a5ac5a51573f75976e82d848a2034",    
        "tenantId":"B933C64DC62844ED90B2485C01DEB15C",
        "ratio":{1},
        "childName":"222",
        "childLoginName":"xxx12",
        "childDescribe":"",
        "childIdentityId":"19EE233915434670A1522A6730316AD7",
        "childTenantId":"tenantid_DQBWTKQ63WBBV1SKONLC"
    }
}

正常返回示例

{
  "code": 200,
  "data": 23,
  "localizedMsg": null,
  "message": "success"
}

错误码

错误码 错误信息 详细描述
29508 current platform info not exist 当前平台信息不存在
29515 fail to create user 创建用户失败

删除关系

定义描述

path 版本 描述 是否需要cloudToken
/cloud/linkbusiness/projectRelation/delete 1.0.1 删除关系 是

请求参数

参数 类型 必填 描述
id Long 是 ID
projectId String 是 项目ID
identityId String 是 项目拥有者的身份id

返回参数

参数 类型 描述
true Boolean true--修改成功

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0",
        "iotToken": "token"
    },
    "params": {
        "id": "1",
        "projectId":"c124z2ZyFWdGwPh7",
        "tenantId":"B933C64DC62844ED90B2485C01DEB15C"
    }
}

正常返回示例

{
  "code": 200,
  "data": true,
  "message": "success",
  "localizedMsg": null
}

错误码

错误码 错误信息 详情描述
29673 id not existed id不存在

查当前项目的直接下级项目

定义描述

path 版本 描述 是否需要cloudToken
/cloud/linkbusiness/projectRelation/query 1.0.1 查当前项目的直接下级项目 是

请求参数

参数 类型 必填 描述
projectId String 是 项目ID
childName String 否 运营商名称

返回参数

参数 类型 描述
id Long 主键id
isolationId String 项目资源隔离id
identityId String 项目拥有者的身份id
childIdentityId String 子项目拥有者的身份id
childIsolationId String 子项目资源隔离id
relationType Integer 依赖关系 1-直接依赖，2-间接依赖
authType String 授权关系 upDataAuth -向上数据授权
tenantId String 租户id
targetTenantId String 目标租户id(下级代理)
ratio BigDecimal 分账比例
channel String alipay-支付宝，wechat-微信
level Integer 渠道层级 1-第1级，2-第二级，3-第3级
childName String 子项目管理员名称(运营商名称)
childLoginName String 子项目管理员的登录名
childDescribe String 子项目管理员的描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0",
        "iotToken": "token"
    },
    "params": {
        "projectId":"c124z2ZyFWdGwPh7",
        "childName":"003",
        "tenantId":"B933C64DC62844ED90B2485C01DEB15C"
    }
}

正常返回示例

{
  "code": 200,
  "data": {
    "total": 1,
    "bean": [
      {
        "relationType": 1,
        "childDescribe": null,
        "gmtModified": null,
        "childLoginName": "兰兰测试003",
        "level": 1,
        "channel": null,
        "isolationId": "a103fMDLRQ7fW1G5",
        "gmtCreate": null,
        "targetTenantId": "B933C64DC62844ED90B2485C01DEB15C",
        "childIdentityId": "50abal335a59902a909fc19de70a500e8d649288",
        "childIsolationId": null,
        "identityId": "50abal335a59902a909fc19de70a500e8d649288",
        "childName": "003",
        "tenantId": "B933C64DC62844ED90B2485C01DEB15C",
        "id": 44,
        "authType": null,
        "ratio": null
      }
    ]
  },
  "message": "success",
  "localizedMsg": null,
}

错误码

错误码 错误信息 详情描述

修改关系

定义描述

path 版本 描述 是否需要cloudToken
/cloud/linkbusiness/projectRelation/update 1.0.1 修改关系 是

请求参数

参数
类型
必填
描述
id
Long
是
id
identityId
String
是
用户id
isolationId
String
是
项目隔离id
ratio
BigDecimal
否
分账比例
childIdentityId
String
是
下级运营商id
childName
String
是
运营商名称
childLoginName
String
是
下级运营商登录名
childDescribe
String
是
下级运营商描述

返回参数

参数 类型 描述
true Boolean true--修改成功

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0",
        "iotToken": "token"
    },
    "params": {
        "id": "7",
        "ratio":"1"
    }
}

正常返回示例

{
  "code": 200,
  "data": true,
  "message": "success",
  "localizedMsg": null,
}

错误码

错误码 错误信息 详细描述

查询分润规则

定义描述

path 版本 描述 是否需要cloudToken
/cloud/linkbusiness/commercialSplittingRule/query 1.0.1 查询分润规则 是

请求参数

参数 类型 必填 描述
projectId String 是 项目

返回参数

参数
类型
描述
Map<String,BigDecimal>
map
key-isolationId项目资源隔离id
value-ratio分账比例

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0",
        "iotToken": "token"
    },
    "params": {
        "projectId": "test222",
         "childITenantId": "123"
    }
}

正常返回示例

{
  "code": 200,
  "data": {
    "11": 1
  },
  "message": "success",
  "localizedMsg": null
}

错误码

错误码 错误信息 详细描述

results matching ""

    No results matching ""