---
name: task-publish
description: >-
  创建并发布招标/悬赏任务，或发起指定服务商的雇佣。
  Use when creating, publishing, or posting a task or hire request.
---

# task-publish

## When to use

- 雇主发布招标（bid）或悬赏（bounty）任务
- 雇主向指定服务商发起雇佣（employ）

## Prerequisites

- JWT 登录
- 悬赏发布需余额托管（`payment_method=balance`）
- 雇佣创建后须引导用户完成托管，对方才能接单

## Endpoints

Base: `/api/v1`

### `POST /tasks`（需登录，常 201）

```json
{
  "title": "标题",
  "category_id": 1,
  "budget": 100,
  "mode": "bid",
  "description": "需求说明",
  "delivery_deadline": "2026-12-31",
  "provider_count": 1,
  "skill_ids": [],
  "attachment_uuids": [],
  "pay_type": 1,
  "payment_method": "balance",
  "bounty_mode": "equal",
  "bounty_awards": []
}
```

| 字段 | 必填 | 说明 |
|------|------|------|
| title | 是 | |
| category_id | 是 | |
| budget | 是 | >0 元 |
| mode | 否 | `bid`(默认) \| `bounty` |
| payment_method | 悬赏必填 | 现仅 `balance` |
| bounty_mode | 否 | `equal` \| `custom` |
| bounty_awards | custom 时 | `{winner_count, amount_per_person}[]` |
| pay_type | 否 | 招标 1–4 |

### `POST /employ`（需登录，常 201）

```json
{
  "provider_user_uuid": "服务商 user uuid",
  "title": "标题",
  "description": "说明",
  "budget": 100,
  "delivery_deadline": "2026-12-31",
  "accept_deadline": "2026-12-01",
  "pay_type": 1
}
```

## Workflow

1. （可选）`GET /categories`、`GET /skill-categories` 取分类与技能
2. 大厅任务 → `POST /tasks`
3. 指定威客 → `POST /employ` → 再完成托管后再等待接单
4. 用返回的任务 id（Sonyflake 字符串）继续后续操作

## Errors

- 400 参数错误 / 悬赏金额无效 / mode 非法
- 401 未登录
- 服务暂不可用或未实现时，以响应 `message` 为准

## Availability

- 发布字段以上表为准；若服务端对部分可选字段尚未接受，勿强行臆造扩展字段重试
- `POST /employ` 若返回未实现类错误，如实告知用户，勿编造成功结果
