Skip to main content
Version: 3.0 版本

1.0-任务管理

对任务信息进行上传、查询

1.1 任务所属类别查询

简要描述
  • 获取任务所属类别列表
请求 URL
  • /regulator/openapi/v3/task/first_category
请求方式
  • GET
返回类型
  • JSON
请求参数说明

暂无

返回参数说明

参数名称参数类型参数说明备注
msgstring返回结果描述
codestring返回状态码200 成功，其他均为失败
successboolean是否成功true/false
datalist返回数据任务所属类别列表
正确返回示例
{
  "requestId": "4e1ae43b92f4b5a5",
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": [
    "音视频服务",
    "配送服务费",
    "运输组织服务",
    "软件维护服务",
    "软件测试服务",
    "软件服务类"
  ],
  "errorData": null
}
错误返回示例
{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}

1.2 批量创建任务

简要描述
  • 批量创建任务,明细上限1000
请求 URL
  • /regulator/openapi/v3/task/batch_create
请求方式
  • POST
返回类型
  • JSON
请求参数说明
参数名称参数类型必填参数说明备注
bizBatchCodestringY业务批次号（需唯一），长度：14
productIdLongY产品ID，纽业态（醴陵）:24，纽业态（灵宸）:33
detailsListY任务明细（明细结构如下）
任务明细参数说明
参数名称参数类型必填参数说明备注
firstCategorystringY任务所属类别,参考[1.1 任务所属类别列表]接口
bizDetailCodestringY业务明细编号 (客户传入的单个任务的唯一编号) ，长度：14
namestringY任务名称
amountbigDecimalY任务金额
contentstringY任务需求
realNamestringY接单人姓名
identityNostringY接单人证件号码
accountNostringY交易账号
accountTypestringN账户类型（不填默认银行卡） 1.银行卡
phonestringY手机号

返回参数说明

参数名称参数类型参数说明备注
msgstring返回结果描述
codestring返回状态码200 成功，其他均为失败
successboolean是否成功true/false
datastring返回数据
请求参数示例
{
  "bizBatchCode": "ROM211222000001",
  "productId": 33,
  "details": [
    {
      "identityNo": "516081197209097612",
      "realName": "张三",
      "amount": 597.97,
      "phone": "13852554102",
      "firstCategory": "其他-咨询/法律顾问",
      "bizDetailCode": "ROS21122200001",
      "name": "信息服务",
      "accountNo": "4027913265167259",
      "accountType": "1",
      "content": "信息服务"
    },
    {
      "identityNo": "529099198606229431",
      "realName": "李四",
      "amount": 326.38,
      "phone": "17694642834",
      "firstCategory": "其他-咨询/法律顾问",
      "bizDetailCode": "ROS21122200002",
      "name": "信息服务",
      "accountNo": "4027913680696064",
      "accountType": "1",
      "content": "信息服务"
    }
  ]
}
正确返回示例
{
  "requestId": "d72d037ae3f7fecf",
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": null,
  "errorData": null
}
错误返回示例
{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}
备注

1.3 批次主体查询

简要描述
  • 查询批次主体的信息
请求 URL
  • /regulator/openapi/v3/task/batch_main/{bizBatchCode}
请求方式
  • GET
返回类型
  • JSON
请求参数说明
参数名称参数类型必填参数说明备注
bizBatchCodestringY业务批次号（需唯一），长度：14

返回参数说明

参数名称参数类型参数说明备注
msgstring返回结果描述
codestring返回状态码200 成功，其他均为失败
successboolean是否成功true/false
dataobject返回数据批次信息

批次信息参数说明

参数名称参数类型参数说明备注
bizBatchCodestring业务批次编号 (客户传入的单个批次的唯一编号)
extraBatchCodestring外部批次编号 (纽业态系统任务批次编号,成功后返回)
totalNuminteger任务总数
successNuminteger成功数量
statusinteger批次状态参考数据字典-0012-任务批次状态
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "bizBatchCode": "ROM211222000001",
    "extraBatchCode": "I2021060200001",
    "totalNum": 2,
    "successNum": 1,
    "status": 4
  }
}
错误返回示例
{
  "msg": "参数缺失",
  "code": "010001",
  "success": false,
  "data": null
}
备注

1.4 批次明细查询

简要描述
  • 查询批次明细(默认分页)
请求 URL
  • /regulator/openapi/v3/task/batch_detail/page
请求方式
  • GET
返回类型
  • JSON
请求参数说明

业务批次号和外部批次编号二选一

参数名称参数类型必填参数说明备注
pageNointegerN页码，默认 1
pageSizeintegerN页码，默认 20
bizBatchCodestringN业务批次号
extraBatchCodestringN外部批次编号 (纽业态系统任务批次编号)

返回参数说明

参数名称参数类型参数说明备注
msgstring返回结果描述
codestring返回状态码200 成功，其他均为失败
successboolean是否成功true/false
dataobject返回数据分页对象

分页对象参数说明

参数名称参数类型参数说明备注
pageNointeger页码
pageSizeinteger分页条数
pageCountinteger总页数
totalCountinteger总数
entityListlist明细列表

明细参数说明

参数名称参数类型参数说明备注
bizBatchCodestring业务批次号
bizDetailCodestring业务明细编号
extraBatchCodestring外部批次编号 (纽业态系统任务批次编号)
extraDetailCodestring外部明细编号 (纽业态系统任务编号)
firstCategorystring任务所属类别
realNamestring真实姓名
identityNostring身份证
accountNostring交易账号
accountTypestring账户类型 1.银行卡
phonestring手机号
productIdLong产品ID，纽业态（醴陵）:24，纽业态（灵宸）:33
statusinteger任务状态参考数据字典-0013-批次任务明细状态
failMsgstring失败原因
namestring任务名称
amountbigdecimal任务金额
contentstring任务需求
bankNamestring银行名称
createTimeStrstring创建时间
正确返回示例
{
  "msg": "请求成功",
  "code": "200",
  "success": true,
  "data": {
    "pageNo": 1,
    "pageSize": 20,
    "pageCount": 1,
    "totalCount": 2,
    "entityList": [
      {
        "bizBatchCode": "ROM211222000001",
        "extraBatchCode": "I2021060200001",
        "bizDetailCode": "ROS21122200001",
        "extraDetailCode": "T20211216000011",
        "firstCategory": "其他-咨询/法律顾问",
        "realName": "能徊包",
        "accountType": "1",
        "identityNo": "413726197901230253",
        "accountNo": "6217211107001880725",
        "phone": "13955366520",
        "productId": 33,
        "status": 2,
        "failMsg": "",
        "name": "信息服务",
        "amount": 126.44,
        "content": "信息服务",
        "bankName": null,
        "createTimeStr": "2020-07-20 14:50:56"
      },
      {
        "bizBatchCode": "ROM211222000001",
        "extraBatchCode": "I2021060200001",
        "bizDetailCode": "ROS21122200002",
        "extraDetailCode": "T20211216000012",
        "firstCategory": "其他-咨询/法律顾问",
        "realName": "节关拉",
        "accountType": "1",
        "identityNo": "330683198212275468",
        "accountNo": "13952468339",
        "phone": "13952468339",
        "productId": 33,
        "status": 3,
        "failMsg": "身份证校验失败",
        "name": "信息服务",
        "amount": 383.97,
        "content": "信息服务",
        "bankName": null,
        "createTimeStr": "2020-07-20 14:50:42"
      }
    ]
  }
}
备注