https://api.example.com/api/v1{
"code": 0,
"message": "success",
"data": {}
}| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 1001 | 参数错误 |
| 1002 | 认证失败 |
| 1003 | Token 过期或无效 |
| 1004 | 权限不足 |
| 5001 | 服务器内部错误 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer Token (格式: Bearer {token}) |
POST /auth/token| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appkey | string | 是 | 渠道唯一标识 |
| secret | string | 是 | 渠道密钥 |
| grant_type | string | 是 | 固定值: client_credentials |
{
"appkey": "channel_001",
"secret": "your_secret_key",
"grant_type": "client_credentials"
}{
"code": 0,
"message": "success",
"data": {
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"expires_in": 7200,
"refresh_token": "refresh_token_string"
}
}POST /auth/refresh| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| refresh_token | string | 是 | 刷新令牌 |
| grant_type | string | 是 | 固定值: refresh_token |
POST /users| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 用户姓名 |
| id_card | string | 是 | 身份证号码 |
| phone | string | 是 | 手机号码 |
| channel_user_id | string | 是 | 渠道用户唯一标识 |
| live_certification | object | 否 | 活体认证记录 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| certified | boolean | 是 | 是否通过活体认证 |
| certification_time | string | 是 | 认证时间 (ISO 8601 格式) |
| certification_method | string | 否 | 认证方式 (如: face++, 支付宝活体) |
| face_score | float | 否 | 人脸比对分数 |
| liveness_score | float | 否 | 活体检测分数 |
| photos | array | 否 | 活体认证照片URL列表 |
{
"channel_user_id": "U20240101001",
"name": "张三",
"id_card": "110101199001011234",
"phone": "13800138000",
"live_certification": {
"certified": true,
"certification_time": "2024-01-15T10:30:00Z",
"certification_method": "支付宝活体",
"face_score": 95.5,
"liveness_score": 98.2,
"photos": [
"https://cdn.example.com/face/photo1.jpg"
]
}
}{
"code": 0,
"message": "success",
"data": {
"user_id": "10001",
"channel_user_id": "U20240101001",
"created_at": "2024-01-15T10:30:00Z"
}
}PUT /users/:channel_user_idGET /users/:channel_user_idPOST /companies| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_company_id | string | 是 | 渠道企业唯一标识 |
| company_name | string | 是 | 企业名称 |
| social_credit_code | string | 是 | 统一社会信用代码 |
| legal_person | string | 否 | 法定代表人 |
| contact_person | string | 否 | 联系人 |
| contact_phone | string | 否 | 联系电话 |
| business_license | object | 否 | 营业执照信息 |
| registered_address | string | 否 | 注册地址 |
| business_scope | string | 否 | 经营范围 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| license_number | string | 是 | 营业执照编号 |
| license_photo | string | 否 | 营业执照照片URL |
| issue_date | string | 否 | 发证日期 |
| expiry_date | string | 否 | 有效期至 |
| registration_capital | float | 否 | 注册资本 |
| paid_in_capital | float | 否 | 实缴资本 |
{
"channel_company_id": "C20240101001",
"company_name": "某某科技有限公司",
"social_credit_code": "91110000MA00ABCD01",
"legal_person": "李四",
"contact_person": "王五",
"contact_phone": "010-12345678",
"registered_address": "北京市朝阳区某某街道",
"business_scope": "技术开发、技术服务",
"business_license": {
"license_number": "91110000MA00ABCD01",
"license_photo": "https://cdn.example.com/license.jpg",
"issue_date": "2020-01-01",
"expiry_date": "2050-12-31",
"registration_capital": 1000000,
"paid_in_capital": 500000
}
}{
"code": 0,
"message": "success",
"data": {
"company_id": "20001",
"channel_company_id": "C20240101001",
"created_at": "2024-01-15T10:30:00Z"
}
}PUT /companies/:channel_company_idGET /companies/:channel_company_idPOST /tasks| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_task_id | string | 是 | 渠道任务唯一标识 |
| channel_company_id | string | 是 | 关联企业标识 |
| task_name | string | 是 | 任务名称 |
| task_type | string | 是 | 任务类型 (如: 短期工、长期工、兼职) |
| recruit_count | integer | 是 | 招募人数 |
| recruitment_start_time | string | 是 | 招募开始时间 |
| recruitment_end_time | string | 是 | 招募结束时间 |
| work_start_time | string | 否 | 工作开始时间 |
| work_end_time | string | 否 | 工作结束时间 |
| wage_description | string | 否 | 劳务费用发放说明 |
| recruitment_description | string | 否 | 招募说明 |
| work_location | string | 否 | 工作地点 |
| job_requirements | string | 否 | 岗位要求 |
| salary | object | 否 | 薪资信息 |
| status | string | 否 | 任务状态 (open/closed/suspended) |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| salary_type | string | 是 | 薪资类型 (hourly/月薪/日薪/按件) |
| amount | float | 是 | 薪资金额 |
| currency | string | 否 | 货币类型 (默认: CNY) |
| settlement_type | string | 否 | 结清类型 (日结/周结/月结/完工结) |
{
"channel_task_id": "T20240101001",
"channel_company_id": "C20240101001",
"task_name": "春节临时工招聘",
"task_type": "短期工",
"recruit_count": 100,
"recruitment_start_time": "2024-01-20T00:00:00Z",
"recruitment_end_time": "2024-02-10T23:59:59Z",
"work_start_time": "2024-02-01T08:00:00Z",
"work_end_time": "2024-02-15T18:00:00Z",
"work_location": "北京市朝阳区某某工厂",
"job_requirements": "身体健康,能吃苦耐劳",
"wage_description": "按月结算,次月15日发放工资",
"recruitment_description": "招聘春节期间临时工,负责流水线作业",
"salary": {
"salary_type": "月薪",
"amount": 5000,
"currency": "CNY",
"settlement_type": "月结"
},
"status": "open"
}{
"code": 0,
"message": "success",
"data": {
"task_id": "30001",
"channel_task_id": "T20240101001",
"created_at": "2024-01-15T10:30:00Z"
}
}PUT /tasks/:channel_task_idGET /tasks/:channel_task_idGET /tasks| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_company_id | string | 否 | 按企业筛选 |
| status | string | 否 | 按状态筛选 |
| page | integer | 否 | 页码 (默认: 1) |
| page_size | integer | 否 | 每页数量 (默认: 20) |
POST /applications| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_application_id | string | 是 | 渠道投递唯一标识 |
| channel_user_id | string | 是 | 用户标识 |
| channel_task_id | string | 是 | 任务标识 |
| applied_at | string | 是 | 投递时间 |
| resume_url | string | 否 | 简历URL |
| application_channel | string | 否 | 投递渠道来源 |
| status | string | 否 | 投递状态 (pending/accepted/rejected/cancelled) |
| remark | string | 否 | 备注 |
{
"channel_application_id": "A20240101001",
"channel_user_id": "U20240101001",
"channel_task_id": "T20240101001",
"applied_at": "2024-01-18T14:30:00Z",
"resume_url": "https://cdn.example.com/resume.pdf",
"application_channel": "渠道A",
"status": "pending"
}{
"code": 0,
"message": "success",
"data": {
"application_id": "40001",
"channel_application_id": "A20240101001",
"created_at": "2024-01-18T14:30:00Z"
}
}PUT /applications/:channel_application_idGET /applications/:channel_application_idGET /applications| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_user_id | string | 否 | 按用户筛选 |
| channel_task_id | string | 否 | 按任务筛选 |
| status | string | 否 | 按状态筛选 |
| start_date | string | 否 | 开始日期 |
| end_date | string | 否 | 结束日期 |
| page | integer | 否 | 页码 |
| page_size | integer | 否 | 每页数量 |
POST /payments| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_payment_id | string | 是 | 渠道付款唯一标识 |
| payment_type | string | 是 | 付款类型 (user/application) |
| channel_user_id | string | 否 | 用户标识 (payment_type=user 时必填) |
| channel_application_id | string | 否 | 投递记录标识 (payment_type=application 时必填) |
| amount | float | 是 | 付款金额 |
| currency | string | 否 | 货币类型 (默认: CNY) |
| payment_time | string | 是 | 付款时间 |
| payment_method | string | 否 | 付款方式 (银行转账/支付宝/微信/现金) |
| payment_channel | string | 否 | 付款渠道 |
| bank_name | string | 否 | 银行名称 |
| bank_account | string | 否 | 银行账号 |
| transaction_no | string | 否 | 交易流水号 |
| payment_basis | object | 是 | 付款依据 |
| status | string | 否 | 付款状态 (pending/completed/failed) |
| remark | string | 否 | 备 注 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| basis_type | string | 是 | 依据类型 (工时/件数/月薪/日薪) |
| work_hours | float | 否 | 工时数 |
| work_date_start | string | 否 | 工作开始日期 |
| work_date_end | string | 否 | 工作结束日期 |
| description | string | 否 | 计算说明 |
| supporting_docs | array | 否 | 证明材料URL列表 |
{
"channel_payment_id": "P20240101001",
"payment_type": "application",
"channel_application_id": "A20240101001",
"channel_user_id": "U20240101001",
"amount": 5000,
"currency": "CNY",
"payment_time": "2024-02-20T10:00:00Z",
"payment_method": "银行转账",
"payment_channel": "中国工商银行",
"bank_name": "中国工商银行北京分行",
"bank_account": "6222021234567890123",
"transaction_no": "IOU20240220001",
"payment_basis": {
"basis_type": "月薪",
"work_date_start": "2024-02-01",
"work_date_end": "2024-02-15",
"description": "2024年2月1日-15日工资",
"supporting_docs": [
"https://cdn.example.com/salary_sheet.pdf"
]
},
"status": "completed"
}{
"code": 0,
"message": "success",
"data": {
"payment_id": "50001",
"channel_payment_id": "P20240101001",
"created_at": "2024-02-20T10:00:00Z"
}
}PUT /payments/:channel_payment_idGET /payments/:channel_payment_idGET /payments| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel_user_id | string | 否 | 按用户筛选 |
| channel_application_id | string | 否 | 按投递记录筛选 |
| payment_type | string | 否 | 按付款类型筛选 |
| status | string | 否 | 按状态筛选 |
| start_date | string | 否 | 开始日期 |
| end_date | string | 否 | 结束日期 |
| page | integer | 否 | 页码 |
| page_size | integer | 否 | 每页数量 |
| 类型 | 说明 |
|---|---|
| string | 字符串 |
| integer | 整数 |
| float | 浮点数 |
| boolean | 布尔值 (true/false) |
| array | 数组 |
| object | 对象 |
| ISO 8601 | 日期时间格式: YYYY-MM-DDTHH:MM:SSZ |
| 类型编码 | 说明 |
|---|---|
| short_term | 短期工 |
| long_term | 长期工 |
| part_time | 兼职 |
| intern | 实习生 |
| 类型编码 | 说明 |
|---|---|
| hourly | 时薪 |
| daily | 日薪 |
| monthly | 月薪 |
| piece | 计件 |