京翎云享 京翎云享
首页
  • 商户操作手册
  • 商户对接文档
  • 数据对接文档
  • SaaS服务平台
  • 三方灵工平台对接接口
首页
  • 商户操作手册
  • 商户对接文档
  • 数据对接文档
  • SaaS服务平台
  • 三方灵工平台对接接口
  • 灵活用工系统

    • 灵活用工系统
  • 商户对接接口

    • 商户对接接口
      • 一、文档概述
        • 1、对接须知
      • 二、业务流程
      • 三、通用信息
        • 1、验签demo(点击下载)
        • 2、环境地址
      • 四、接口列表
        • 1、查询园区
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数说明
        • (6)返回示例
        • 2、查询发票类目
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数
        • (6)返回示例
        • 3、查询任务模板
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数
        • (6)返回示例
        • 4、创建任务
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
        • 5、新增用户
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
        • 6、查询用户认证状态
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
        • 7、上传分包名单
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数
        • (6)返回示例
        • 8、任务派发
        • (1)接口描述
        • (2)请求URL
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
        • 9、任务验收
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数
        • (6)返回示例
        • 10、结算金额确认
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数
        • (6)返回示例
        • 11、众包费用支付
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
        • 12、获取支付结果
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)返回参数
        • (6)返回示例
        • 13、重试打款
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
        • 14、新增用户(返回签约地址)
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5) 请求示例
        • (5)返回参数说明
        • (6)返回示例
        • 15、用户认证状态通知
        • (1)接口描述
        • (2)请求方式
        • (3)请求参数
        • (4)请求示例
        • 16、查询用户认证信息
        • (1)接口描述
        • (2)请求URL
        • (3)请求方式
        • (4)请求参数
        • (5)请求示例
        • (6)返回参数
        • (7)返回示例
  • 数据接口对接

    • 数据接口对接
  • SaaS服务平台

    • SaaS服务平台
  • 三方灵工平台对接接口

    • 三方灵工平台对接接口
  • 操作手册
  • 商户对接接口
京翎云享
2024-03-13
目录

商户对接接口

# 商户对接接口文档

# 一、文档概述

# 1、对接须知

(1)联系商务申请测试环境数据;

(2)接口调用顺序:按照四、接口列表从上向下调用,所有接口均须对接;

(3)使用前请注意区分生产环境和测试环境;

(4)生产环境接口及参数将在整体接口验收通过且风控审核通过后提供;

(5)若您有特殊需求请联系商务申请。

(6)如无特殊说明:单接口请求并发限制为5次/秒,请求间隔须超过200ms

# 二、业务流程

1、查询园区,可查询到企业绑定的所有园区ID、园区名称及园区可发放额度。

2、查询发票类目,可查询到发票类目ID及发票内容。

3、查询任务模板,上传发票类目ID获取任务模板信息数据。

4、创建任务,获取任务ID,任务ID可用于任务派发、任务验收、确认汇款金额、支付及重试打款操作。

5、新增用户,进行用户认证,认证通过方可进行任务派发。

6、查询用户认证状态,查询用户最新的认证状态。

7、上传分包名单,获得分包名单批次号,批次号可用于任务派发、任务验收操作。

8、任务派发,上传任务ID、园区ID、分包名单批次号进行任务派发,任务派发成功后方可进行任务验收。

9、任务验收,上传任务ID进行任务验收

10、确认结算金额,上传任务ID确认汇款金额

11、众包费用支付,上传orderID和taskID进行单笔支付;上传taskID进行批量支付。

12、获取支付结果,完成支付后可上传任务ID获取支付状态。

13、重试打款,支付结果显示支付失败后,可重试打款,再次发起支付请求。

# 三、通用信息

# 1、验签demo(点击下载)

https://yun.jinglingyunxiang.com/var/upload/demo.java (opens new window)

# 2、环境地址

名称 地址
测试环境 https://devyun.jinglingyunxiang.com/ (opens new window)
生产环境 https://yun.jinglingyunxiang.com/ (opens new window)

# 四、接口列表

# 1、查询园区

# (1)接口描述

根据上传企业唯一标识码及验签串查询该商户账号所绑定的园区列表,及园区月度发放限额。

# (2)请求URL

/task_platform/lhyg/selectPark?identification= &sign=
1

# (3)请求方式

GET

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 string 企业唯一标识
sign 是 string 验签串

# (5)返回参数说明

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 返回内容

data参数说明:

参数名 类型 说明
idparkId int 园区ID
parkName String 园区名称
quota BigDecimal 园区月度发放限额

# (6)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": [
    {
      "parkId": 24,
      "parkName": "湖南来来信息科技有限公司",
      "quota": 0
    },
    {
      "parkId": 27,
      "parkName": "九江鼎高信息技术有限公司",
      "quota": 0
    },
    {
      "parkId": 25,
      "parkName": "九江蝉灵科技有限公司",
      "quota": 0
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 2、查询发票类目

# (1)接口描述

查询园区的可开发票类目(对应创建任务的需求类型),返回信息用于创建任务

# (2)请求URL

/task_platform/lhyg/selectCategory?identification= &sign=
1

# (3)请求方式

GET

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

# (5)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 返回内容

data参数说明:

参数名 类型 说明
invoiceId string 发票类目ID
content string 发票类目内容

# (6)返回示例

{
    "success": true,
    "message": "succeed",
    "code": 200,
    "data": [
        {
            "content": "*现代服务*市场推广费",
            "invoiceId": 1092
        },
        {
            "content": "*现代服务*服务费",
            "invoiceId": 1134
        },
        {
            "content": "*生活服务*保洁服务",
            "invoiceId": 805
        },
        {
            "content": "*文化服务*文化策划服务费",
            "invoiceId": 855
        },
        {

    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 3、查询任务模板

# (1)接口描述

查询发票类目下的任务模板,返回信息可用于创建任务(若您要使用的类目下没有模板信息,请通过商户平台-模板管理,创建符合实际业务的任务模板,同一类目,模板仅需创建一次,后续可直接使用)。

# (2)请求URL

/task_platform/lhyg/selectCategoryInfo?invoiceId= &sign=
1

# (3)请求方式

GET

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
invoiceId 是 string 发票类目ID
sign 是 string 验签串

# (5)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 返回内容

data参数说明:

参数名 类型 说明
id Integer 任务模版ID
taskType String 需求标题
description String 需求描述
typeid Integer 发票类目ID
thirdInfoId Integer 园区ID

# (6)返回示例

{
    "success": true,
    "message": "succeed",
    "code": 200,
    "data": [
        {
            "id": 1127,
            "taskType": "公司活动策划",
            "description": "公司组织活动庆典仪式、活动现场布置等",
            "typeid": 855,
            "thirdInfoId": 37
        }
    ]
} 
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 4、创建任务

# (1)接口描述

按照实际业务场景,创建符合业务要求及平台规范的任务,其中涉及业务实际发生地,请联系技术支持获取对应地区ID

# (2)请求URL

/task_platform/lhyg/createTask?identification= &sign=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
name 是 String 任务标题(填写查询的模板ID对应的taskType)
description 是 String 描述(填写查询的模板ID对应的description)
budget 是 BigDecimal 预算金额
enrollEndTime 是 Date 报名截止时间(yyyy-MM-dd HH:mm:ss)
enrollStartTime 是 Date 报名开始时间
endTime 是 Date 任务结束时间
startTime 是 Date 任务开始时间
checkTime 否 Integer 验收时间
checkTimeUnit 是 Integer 验收时间单位:1:每日,2:每时,3:每分
demand 是 String 任务要求
workingPlace 是 String 任务地点
enrollNum 是 Integer 需求人数
remark 否 String 备注
taxType 是 Integer 发票类目ID(调用2、查询发票类目返回的invoiceId)
principalId 是 String 地区id(联系技术获取固定值)
titleid 是 Integer 任务模板ID(调用3、查询任务模板返回的ID)
settlementsId 是 Integer 1-平安银行; 2-支付宝; 4、招商银行;5、南京银行 6、银联
thirdInfoId 是 Integer 园区id

# (5)请求示例

{
    "name":"任务标题",
    "description":"任务描述",
    "budget":70000,
    "enrollEndTime":"2022-5-13 12:00:00",
    "enrollStartTime":"2022-5-11 12:00:00",
    "endTime":"2022-5-13 12:00:00",
    "startTime":"2022-5-11 12:00:00",
    "checkTime":1,
    "checkTimeUnit":1,
    "demand":"任务要求",
    "workingPlace":"全国,全省市",
    "enrollNum":10000,
    "remark":"备注",
    "taxType": 29,
    "principalId":"1,3409",
    "titleid":41,
    "settlementsId":4,
    "thirdInfoId":26
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data Object 返回内容

data参数说明:

参数名 类型 说明
taskId Integer 任务ID

# (7)返回示例

{
    "success": true,
    "message": "succeed",
    "code": 200,
    "data": {
        "taskId": 19314
    }
}
1
2
3
4
5
6
7
8

# 5、新增用户

# (1)接口描述

通过此接口为自由职业者进行认证。如果用户已存在,可自行选择跳过此条信息或重新为自由职业者进行认证;本接口需要您自行处理服务协议签约,将个人签署完成的服务协议PDF文件URL传输至我方;请确保身份证正反面、协议文件的URL可在公网访问、下载。

点击下载共享经济合作伙伴协议 (opens new window)协议模版文件。

# (2)请求URL

/task_platform/lhyg/importUsers?identification=&sign=&flag=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 string 企业唯一标识
sign 是 string 验签串
flag 是 Integer 个人信息重复处理规则:1-覆盖  2-跳过

Body参数说明(list,支持批量新增):

参数名 必选 类型 说明
name 是 String 姓名
idcard 是 String 身份证
phone 是 String 手机号
bankcard 是 String 银行卡
bank 是 String 银行名称,按照附件表 (opens new window)匹配银行名称(bank_name字段)
idcardType 否 String 证件照片是复印件还是扫描件:1:扫描件 2:复印件
idcardUrl1 否 String 身份证正面照片的下载链接
idcardUrl2 否 String 身份证反面照片的下载链接
serviceUrl 否 String 服务协议文件的下载链接;(请联系商务获取)
dataLevel 是 String 资料级别:详见下方说明
资料级别说明: 
 1:四要素信息+证件照片+协议(需要进行人工审核)

 2:四要素信息+证件照片(验证通过直接放入正式用户库并且更新用户状态为已认证)
 
 3:四要素信息(验证通过直接放入正式用户库并且更新用户状态为已认证)
 
 4、四要素信息+协议(需要人工审核)
 
  	当资料级别为1、2时,证件照片类型、身份证正面照片、身份证反面照片等字段必填
  
  	当资料级别为1、4时,服务协议字段必填

# (5)请求示例

[
    {
		"serviceUrl": "https://devyun.jinglingyunxiang.com/var/upload/logo.png",
        "idcardUrl1": "https://devyun.jinglingyunxiang.com/var/upload/sj/1.jpg",
        "bank": "",
        "idcardUrl2": "https://devyun.jinglingyunxiang.com/var/upload/sj/2.jpg",
        "phone": "144100000040",
        "idcard": "62052133254501562",
        "name": "张三",
        "idcardType": 1,
        "bankcard": "6214680050202222",
        "dataLevel": 1
    }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data Object 用户信息处理结果

# (7)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": "用户总数:1人,成功录入:1人,失败录入:0人"
}
1
2
3
4
5
6

# 6、查询用户认证状态

# (1)接口描述

提交用户资料后,可通过身份证号查询用户认证状态。

# (2)请求URL

/task_platform/lhyg/getUserStatus?sign= &identification=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
idCardList 是 List 个人身份证号列表

# (5)请求示例

{
    "idCardList": [
        "42032219600118042X",
        "420322196001180422"
        ]
}
1
2
3
4
5
6

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 用户认证信息详情

data参数说明:

参数名 类型 说明
phone String 用户手机号码
idcard String 用户身份证号
name String 用户姓名
stuts String 个人认证状态: 1、待审核、3、审核通过、4、审核驳回 10、待扫码签约
remark String 驳回原因
message String 状态文字说明

# (7)返回示例

{
  "success": True,
  "message": "succeed",
  "code": 200,
  "data": [
    {
      "phone": "17624018035",
      "idcard": "42032219600118042X",
      "name": "祖起",
      "stuts": 3,
      "remark": "",
      "message": "审核通过"
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 7、上传分包名单

# (1)接口描述

上传个人下发明细名单,包含个人姓名、身份证号、工作内容、下发金额等信息,上传过程中整批数据需严格按照格式规范及确保信息正确才能上传成功,上传前请确认个人已认证通过,避免影响下发流程。

# (2)请求URL

/task_platform/lhyg/taskUserUpload?identification=&sign=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
file 是 mulipartFile 分包名单文件:点击下载《模板文档 (opens new window) "模板文档")》
parkId 是 Integer 园区ID

# (5)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data Integer 分包名单批次号(请保存)

# (6)返回示例

{
    "success": true,
    "message": "succeed",
    "code": 200,
    "data": 8061
}
1
2
3
4
5
6

# 8、任务派发

# (1)接口描述

通过上传批次号,任务号(taskId),将该任务派发给该批次上传的用户。

# (2)请求URL

/task_platform/lhyg/taskDistribution?identification=&sign=
1
#### (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
taskId 是 Integer 任务Id
parkId 是 integer 园区ID
batch 是 Integer 批次号

# (5)请求示例

{
  "taskId":17139,
  "parkId":55,
  "batch":8060
}
1
2
3
4
5

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data Object 返回内容

# (7)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": "任务派发成功"
}
1
2
3
4
5
6

# 9、任务验收

# (1)接口描述

针对派发给个人的任务进行验收,目前仅支持一键验收,若任务中存在多条个人任务,请通过结算金额确认接口,确认下发人数,下发金额、个人对应金额等信息是否正确

# (2)请求URL

/task_platform/lhyg/taskAcceptance?identification=&sign=&taskId=
1

# (3)请求方式

GET

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串
taskId 是 Integer 任务ID

# (5)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data Integer 返回内容

# (6)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": null
}
1
2
3
4
5
6

# 10、结算金额确认

# (1)接口描述

对已验收个人任务的结算金额进行确认,确认无误后,请通过线下转账的方式向平台子账户充值(提前充值可忽略此步骤)。

# (2)请求URL

/task_platform/lhyg/confirmedAmount?identification=&sign=&taskId=
1

# (3)请求方式

GET

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串
taskId 是 Integer 任务ID

# (5)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 个人下发明细数据

data参数说明:

参数名 类型 说明
name String 个人姓名
idCard String 个人身份证号
meal String 个人工作内容
wages BigDecimal 个人佣金(元)
servicerate BigDecimal 点位(%)
fees BigDecimal 服务费(元)
orderId Integer 个人任务ID(用于单笔支付和重试打款)

# (6)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": [
    {
      "name": "吴极客",
      "idCard": "211000200002027278",
      "meal": "WORK",
      "wages": 100,
      "servicerate": 10,
      "fees": 10,    
	  	"orderId": 126289
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 11、众包费用支付

# (1)接口描述

针对个人已完成的任务进行支付众包佣金,可单独支付某个自由职业者的佣金或一键支付当前任务中所有待支付的所有佣金

# (2)请求URL

/task_platform/lhyg/taskPay?identification=&sign=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
orderId 否 Integer 个人任务ID:通过结算金额确认接口返回的orderId+任务ID可以单笔支付
taskId 是 Integer 只入taskId则一键支付

# (5)请求示例

{
   "orderId":126289,  //通过确认汇款接口返回的orderId+任务ID可以单笔支付
   "taskId":17222    //只入taskId则一键支付
}
1
2
3
4

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data Integer

# (7)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": null
}
1
2
3
4
5
6

# 12、获取支付结果

# (1)接口描述

提交支付后,可通过此接口,获取支付订单的打款结果(目前仅支持批量获取)。

# (2)请求URL

/task_platform/lhyg/getPayResult?identification=&sign=&taskId=
1

# (3)请求方式

GET

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串
taskId 是 Integer 任务ID

# (5)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 个人订单详情

data参数说明:

参数名 类型 说明
id String 订单ID
receivablesName String 收款人
receivingAccount Integer 收款银行账号
receivingBankName String 收款银行名称
idCard String 收款人身份证号
phone String 收款人联系电话
amounts String 打款金额
stuts Integer 支付状态:1:未支付;2:支付成功;3:支付失败;4:删除;5:未知(银行处理中,非最终结果);
statusMessage String 状态描述
failMessage String 错误原因

# (6)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": [
    {
      "id": 126289,
      "receivablesName": "吴极客",
      "amounts": 100,
      "receivingAccount": "6214831150131511",
      "receivingBankName": "中国银行",
      "idCard": "211000200002027278",
      "phone": "17625019034",
      "status": 5,//1:未支付;2:支付成功;3:支付失败;4:删除;5:未知(银行处理中,非最终结果)
      "failMessage": "",
      "statusMessage": "未知"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 13、重试打款

# (1)接口描述

若通过查询接口确认个人支付失败后,请根据失败原因检查对应的信息(个人信息错误、银行卡信息等),调整信息完成后,可调用此接口进行重试操作(重试时系统会自动获取个人的最新信息,提交至银行)。

# (2)请求URL

/task_platform/lhyg/taskPayRetry?identification=&sign=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
orderId 是 Integer 个人任务ID:通过查询支付结果接口返回的Id
taskId 是 Integer 任务ID

# (5)请求示例

{
    "orderId":126289,
    "taskId":17222
}
1
2
3
4

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
Code Integer 请求码
data Integer 处理结果消息

# (7)返回示例

{
  "success": true,
  "message": "succeed",
  "code": 200,
  "data": "重新打款成功"
}
1
2
3
4
5
6

# 14、新增用户(返回签约地址)

# (1)接口描述

通过此接口为自由职业者进行认证。如果用户已存在,可自行选择跳过此条信息或重新为自由职业者进行认证;本接口会返回个人签署协议地址

# (2)请求URL

/task_platform/lhyg/importUsersForServicePdf?identification=&sign=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 string 企业唯一标识
sign 是 string 验签串
flag 是 Integer 个人信息重复处理规则:1-覆盖  2-跳过

Body参数说明(list,支持批量新增):

参数名 必选 类型 说明
name 是 String 姓名
idcard 是 String 身份证号
phone 是 String 手机号
bankcard 是 String 银行卡号
bank 是 String 银行名称,按照附件表 (opens new window)匹配银行名称(bank_name字段)
idcardType 否 String 证件照片是复印件还是扫描件:1:扫描件 2:复印件
idcardUrl1 否 String 身份证正面照片的下载链接
idcardUrl2 否 String 身份证反面照片的下载链接
dataLevel 是 String 资料级别:
notityUrl 是 String 用户认证状态通知地址
资料级别说明: 

 1:四要素信息+证件照片+协议(需要进行人工审核)

 2:四要素信息+证件照片(验证通过直接放入正式用户库并且更新用户状态为已认证)
 
 3:四要素信息(验证通过直接放入正式用户库并且更新用户状态为已认证)
 
 4、四要素信息+协议(需要人工审核):
 
  	当资料级别为1、2时,证件照片类型、身份证正面照片、身份证反面照片等字段必填
  
  	当资料级别为1、4时,服务协议字段必填

# (5) 请求示例

[
    {
        "idcardUrl1": "https://devyun.jinglingyunxiang.com/var/upload/sj/1.jpg",
        "bank": "",
        "idcardUrl2": "https://devyun.jinglingyunxiang.com/var/upload/sj/2.jpg",
        "phone": "144100000040",
        "idcard": "62052133254501562",
        "name": "张三",
        "idcardType": 1,
        "bankcard": "6214680050202222",
        "dataLevel": 4,
				"notityUrl":"https://devyun.jinglingyunxiang.com/var/upload/sj"
    }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# (5)返回参数说明

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 用户签约地址列表

data参数说明:

参数名 类型 说明
id Integer 用户ID
name String 姓名
idcard String 身份证号
signature String 签约地址

# (6)返回示例

{
    "success": true,
    "message": "succeed",
    "code": 200,
    "data": [
        {
            "id": 38854,
            "name": "张三",
            "idcard": "411525200135648695",
            "signature": "https://devyun.jinglingyunxiang.com/service_agreement_signing?userInfo=38854"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# 15、用户认证状态通知

# (1)接口描述

用户签约完成后,向【14、新增用户】传输的notityUrl地址推送用户签约结果

# (2)请求方式

POST JSON

# (3)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型
phone String 用户手机号码
idcard String 用户身份证号
name String 用户姓名
stuts String 个人认证状态: 1-待审核;3-审核通过;4-审核驳回;10-待扫码签约
remark String 驳回原因
message String 状态文字说明

# (4)请求示例

{
    "phone": "17600617885",
    "idcard": "411525200135648695",
    "name": "张三",
    "stuts": "3",
    "message":"",
    "remark":""
}
1
2
3
4
5
6
7
8

# 16、查询用户认证信息

# (1)接口描述

提交用户信息进行认证后,可批量查询用户认证状态。

# (2)请求URL

/task_platform/lhyg/getUserListStatus?sign= &identification=
1

# (3)请求方式

POST JSON

# (4)请求参数

Params参数说明(URL拼接):

参数名 必选 类型 说明
identification 是 String 企业唯一标识
sign 是 String 验签串

Body参数说明:

参数名 必选 类型 说明
page 是 Integer 页数
size 是 Integer 条数

# (5)请求示例

{
    "page": 1,
    "size": 10
}
1
2
3
4

# (6)返回参数

参数名 类型 说明
success Boolean 请求是否成功
message String 请求是否成功
code Integer 请求码
data List 用户认证信息详情

data参数说明:

参数名 类型 说明
phone String 用户手机号码
idcard String 用户身份证号
name String 用户姓名
stuts String 个人认证状态: 1-待审核;3-审核通过;4-审核驳回;10-待扫码签约
remark String 驳回原因
message String 状态文字说明

# (7)返回示例

{
    "success": true,
    "message": "succeed",
    "code": 200,
    "data": [
        {
            "phone": "15112234000",
            "idcard": "412732199807080961",
            "name": "王美丽",
            "stuts": 3,
            "remark": "",
            "message": "审核通过"
        },
        {
            "phone": "17367671265",
            "idcard": "342423199709092245",
            "name": "张三",
            "stuts": 4,
            "remark": "",
            "message": "审核失败"
        },
        {
            "phone": "15265650456",
            "idcard": "130332199506057817",
            "name": "李四",
            "stuts": 10,
            "remark": "",
            "message": "待扫码签约"
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
上次更新: 2024/03/15, 18:16:27
灵活用工系统
数据接口对接

← 灵活用工系统 数据接口对接→

Theme by Vdoing | Copyright © -2024 ©2016-2023 京翎云享平台 版权所有 ICP证: 京ICP备2023008449号-1
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式