API文档
OmicsMarket RESTful API v1
平台使用指南
一、发布任务（买家）
- 注册账号并登录，选择发任务或两者都要用户类型
- 进入「发布任务」页面，填写任务标题、描述、预算、截止日期
- 选择任务类型：悬赏任务（等待投标）或抛单任务（直接指定服务商）
- 任务发布后，等待服务商投标或直接联系服务商
- 选择合适的服务商，平台托管资金
- 服务商交付成果后，确认付款完成交易
二、接任务（卖家）
- 注册账号并登录，选择接任务或两者都要用户类型
- 进行官方认证（可选但推荐，提升信任度）
- 在「发现任务」页面浏览所有开放任务
- 点击感兴趣的任务，查看详情后提交投标（报价+方案）
- 等待买家选择并确认后，开始工作
- 交付成果给买家，买家确认后收款到钱包
- 钱包余额可申请提现
三、钱包与交易
- 充值：提交充值申请 → 管理员工后台确认 → 余额到账
- 提现：申请提现 → 管理员审核 → 银行转账
- 交易手续费：平台收取一定比例服务费
- 交易完成后，资金从托管释放给服务商
四、安全保障
- 资金托管：交易资金由平台托管，完成后才释放
- 官方认证：认证服务商更可靠
- 信誉评价：交易后可互评
- 申诉处理：争议可联系客服处理
认证说明
所有需要认证的API请求，请在Header中包含以下内容：
{"X-API-Key": "your_api_key_here"}
API Key可在用户中心的"API密钥管理"中创建和管理。
任务相关
GET
/api/tasks
获取任务列表
| 参数 | 类型 | 说明 |
|---|---|---|
page |
int | 页码，默认1 |
per_page |
int | 每页数量，默认20 |
type |
string | 任务类型：bid/offer |
status |
string | 状态：open/in_progress/completed |
GET
/api/task/<task_id>
获取任务详情
POST
/api/task
创建新任务
| 参数 | 类型 | 说明 |
|---|---|---|
title |
string | 任务标题（必填，最少5字符） |
description |
string | 任务描述（必填） |
task_type |
string | 类型：bid（悬赏）/offer（抛单） |
category |
string | 分类slug |
budget |
float | 预算金额 |
deadline |
string | 截止日期 ISO格式 |
POST
/api/task/<task_id>/bid
提交投标
| 参数 | 类型 | 说明 |
|---|---|---|
price |
float | 报价金额（必填） |
proposal |
string | 方案说明（必填） |
timeline |
string | 预计工期 |
用户相关
GET
/api/user/profile
获取当前用户资料
GET
/api/user/tasks
获取当前用户参与的任务
官方认证
GET
/api/verification/status
获取当前用户的认证状态（需登录）
返回：is_verified, verification_status, verification_fee
POST
/api/verification/submit
提交官方认证申请（需登录，仅卖家）
| 参数 | 类型 | 说明 |
|---|---|---|
documents |
array | 认证材料路径列表（必填，至少一项） |
reason |
string | 认证说明 |
GET
/api/user/<user_id>/verification
获取指定用户的认证状态（公开）
返回：user_id, username, is_verified, verification_status
消息相关
POST
/api/message/send
发送站内消息
| 参数 | 类型 | 说明 |
|---|---|---|
receiver_id |
int | 收件人ID（必填） |
task_id |
int | 关联任务ID |
content |
string | 消息内容（必填） |
API Key管理
GET
/api/keys
获取用户的API Key列表
POST
/api/key
创建新的API Key
| 参数 | 类型 | 说明 |
|---|---|---|
name |
string | Key名称 |
permissions |
string | 权限范围 |
rate_limit |
int | 速率限制（次/分钟） |
DELETE
/api/key/<key_id>
删除API Key
分类
GET
/api/categories
获取所有任务分类（无需认证）
系统
GET
/api/health
健康检查接口（无需认证）
响应示例
成功响应
{
"success": true,
"data": {
"tasks": [...],
"total": 100,
"page": 1
}
}
错误响应
{
"success": false,
"error": "错误描述"
}