格物开放 API福豆任务

REST API · 接口参考

REST API 参考 · 员工福利购物

福豆任务

管理员发布任务（奖励型：员工完成后得额度；兑换型：员工用额度兑福利），员工报名、提交凭证、兑换，管理员审核与核销。奖励型发布时从企业额度池冻结预算。全部可选，做员工激励时再接。

#管理员：任务列表与概览

GETPOST/v1/enterprise/org/tasks

管理员：任务列表与概览（?filter=）/ 发布任务（带 idempotencyKey）

鉴权用户态可选

出现在员工福利 · 福豆任务、签到与生日

GET

任务列表与概览

可选。新建的在前，每页 20 条。overview 是顶部概览（进行中 / 待审核 / 待核销 / 已结束）。

查询参数

字段	类型	必填	说明
`filter`	string	否	可选值：`all` / `reward` / `consume` / `reviewing`。默认 `"all"`
`cursor`	string	否	翻页游标：取上一页返回的 nextCursor，首页不传

返回字段57 个，点击展开

字段	类型	说明
`overview`	object
`overview.ongoing`	integer
`overview.pendingReview`	integer
`overview.pendingWriteoff`	integer
`overview.ended`	integer
`items`	object[]
`items[].id`	string
`items[].title`	string
`items[].category`	string
`items[].categoryLabel`	string
`items[].description`	string
`items[].coverUrl`	string	可能为 null
`items[].settleMode`	string	可选值：`reward` / `consume`
`items[].points`	number	每人奖励或消耗的额度（100 = 1 元）
`items[].quota`	integer	null = 不限。可能为 null
`items[].remaining`	integer	可能为 null
`items[].startAt`	string
`items[].endAt`	string
`items[].phase`	string	可选值：`not_started` / `ongoing` / `ended`
`items[].needSignup`	boolean
`items[].signupFull`	boolean
`items[].completeMode`	string	可选值：`direct` / `submit`
`items[].reviewMode`	string	可选值：`auto` / `manual`
`items[].needWriteoff`	boolean
`items[].scopeText`	string	如「全体员工」「财务部、仓储部」
`items[].submitSchema`	object[]
`items[].submitSchema[].key`	string
`items[].submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`items[].submitSchema[].label`	string	最长 20
`items[].submitSchema[].required`	boolean
`items[].submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`items[].pickupInfo`	object	消耗型任务的领取信息
`items[].pickupInfo.location`	string
`items[].pickupInfo.timeText`	string
`items[].pickupInfo.startAt`	string
`items[].pickupInfo.endAt`	string
`items[].pickupInfo.rules`	string
`items[].status`	string	可选值：`active` / `ended` / `cancelled`
`items[].scopeKind`	string	可选值：`all` / `departments` / `members`
`items[].scopeIds`	string[]
`items[].signupQuota`	integer	可能为 null
`items[].budgetFrozen`	number	已冻结的预算
`items[].stats`	object
`items[].stats.signedUp`	integer
`items[].stats.joined`	integer
`items[].stats.completed`	integer
`items[].stats.redeemed`	integer
`items[].stats.pendingReview`	integer
`items[].stats.pendingWriteoff`	integer
`items[].version`	integer	编辑时作为 expectedVersion 带回
`items[].editRules`	object	前端据此置灰，服务端照样校验
`items[].editRules.locked`	string[]	当前不可改的字段名
`items[].editRules.minQuota`	integer
`items[].editRules.pointsEditable`	boolean
`items[].editRules.startAtEditable`	boolean
`items[].editRules.minSignupQuota`	integer
`nextCursor`	string	下一页游标；null = 没有下一页。可能为 null

POST

发布任务

可选。奖励型在同一事务里从企业额度池冻结预算（每人额度 × 名额，不限名额时按范围人数），额度池不够返回 POOL_INSUFFICIENT、任务不建；任务结束时未用完的退回额度池。复制任务 = 拿详情预填后再发布。建议传 idempotencyKey。

请求体application/json · 发布与编辑任务的字段。消耗型恒为直接完成、自动审核；只有消耗型有核销与领取信息。

字段	类型	必填	说明
`title`	string	是	最长 30
`description`	string	否	最长 500
`coverUrl`	string	是	封面图 http(s) 地址，发布时必填；用「上传任务封面」拿到
`category`	string	否	奖励型可选 training / learning / survey / activity / other；消耗型可选 festival / daily / activity / other。可选值：`training` / `learning` / `survey` / `activity` / `festival` / `daily` / `other`
`settleMode`	string	是	reward 奖励额度（员工做任务赚）· consume 消耗额度（员工用额度兑换）。可选值：`reward` / `consume`
`points`	integer	是	每人奖励或消耗的额度（100 = 1 元）。≥ 1，≤ 10000000
`quota`	integer	否	名额；不传 = 不限。≥ 1，≤ 100000。可能为 null
`scopeKind`	string	否	可选值：`all` / `departments` / `members`。默认 `"all"`
`scopeIds`	string[]	否	部门 id 或员工平台账号 id（scopeKind 非 all 时必填）
`startAt`	string	否	不传 = 立即开始
`endAt`	string	是	截止时间，必填，须晚于开始时间与现在
`needSignup`	boolean	否
`signupQuota`	integer	否	≥ 1。可能为 null
`completeMode`	string	否	仅奖励型：直接完成 / 提交结果。可选值：`direct` / `submit`。默认 `"direct"`
`reviewMode`	string	否	仅奖励型 + submit：缺省 manual 人工审核。可选值：`auto` / `manual`
`submitSchema`	object[]	否	completeMode = submit 时必填。最多 10 项
`submitSchema[].key`	string	是
`submitSchema[].type`	string	是	可选值：`text` / `image` / `file` / `link`
`submitSchema[].label`	string	是	最长 20
`submitSchema[].required`	boolean	否
`submitSchema[].max`	integer	否	text 字数 / link 长度 / image、file 个数（≤9）上限
`needWriteoff`	boolean	否	仅消耗型：兑换后是否需要线下核销（发领取码）
`pickupInfo`	object	否	消耗型任务的领取信息
`pickupInfo.location`	string	否
`pickupInfo.timeText`	string	否
`pickupInfo.startAt`	string	否
`pickupInfo.endAt`	string	否
`pickupInfo.rules`	string	否
`idempotencyKey`	string	否	最长 128

返回字段53 个，点击展开

字段	类型	说明
`task`	object	管理视角的任务
`task.id`	string
`task.title`	string
`task.category`	string
`task.categoryLabel`	string
`task.description`	string
`task.coverUrl`	string	可能为 null
`task.settleMode`	string	可选值：`reward` / `consume`
`task.points`	number	每人奖励或消耗的额度（100 = 1 元）
`task.quota`	integer	null = 不限。可能为 null
`task.remaining`	integer	可能为 null
`task.startAt`	string
`task.endAt`	string
`task.phase`	string	可选值：`not_started` / `ongoing` / `ended`
`task.needSignup`	boolean
`task.signupFull`	boolean
`task.completeMode`	string	可选值：`direct` / `submit`
`task.reviewMode`	string	可选值：`auto` / `manual`
`task.needWriteoff`	boolean
`task.scopeText`	string	如「全体员工」「财务部、仓储部」
`task.submitSchema`	object[]
`task.submitSchema[].key`	string
`task.submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`task.submitSchema[].label`	string	最长 20
`task.submitSchema[].required`	boolean
`task.submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`task.pickupInfo`	object	消耗型任务的领取信息
`task.pickupInfo.location`	string
`task.pickupInfo.timeText`	string
`task.pickupInfo.startAt`	string
`task.pickupInfo.endAt`	string
`task.pickupInfo.rules`	string
`task.status`	string	可选值：`active` / `ended` / `cancelled`
`task.scopeKind`	string	可选值：`all` / `departments` / `members`
`task.scopeIds`	string[]
`task.signupQuota`	integer	可能为 null
`task.budgetFrozen`	number	已冻结的预算
`task.stats`	object
`task.stats.signedUp`	integer
`task.stats.joined`	integer
`task.stats.completed`	integer
`task.stats.redeemed`	integer
`task.stats.pendingReview`	integer
`task.stats.pendingWriteoff`	integer
`task.version`	integer	编辑时作为 expectedVersion 带回
`task.editRules`	object	前端据此置灰，服务端照样校验
`task.editRules.locked`	string[]	当前不可改的字段名
`task.editRules.minQuota`	integer
`task.editRules.pointsEditable`	boolean
`task.editRules.startAtEditable`	boolean
`task.editRules.minSignupQuota`	integer
`poolBalance`	number	发布后的企业额度池余额
`budgetWarn`	string	超出预算预警线时的提示文案。可能为 null

错误

400 BAD_REQUEST（message 说明哪一项不合法）/ POOL_INSUFFICIENT 企业额度池不足

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/org/tasks" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "overview": {3    "ongoing": 0,4    "pendingReview": 0,5    "pendingWriteoff": 0,6    "ended": 07  },8  "items": [9    {10      "id": "string",11      "title": "string",12      "category": "string",13      "categoryLabel": "string",14      "description": "string",15      "coverUrl": "string",16      "settleMode": "reward",17      "points": 0,18      "quota": 0,19      "remaining": 0,20      "startAt": "string",21      "endAt": "string",22      "phase": "not_started",23      "needSignup": true,24      "signupFull": true,25      "completeMode": "direct",26      "reviewMode": "auto",27      "needWriteoff": true,28      "scopeText": "string",29      "submitSchema": [30        {}31      ],32      "pickupInfo": {33        "location": "string",34        "timeText": "string",35        "startAt": "string",36        "endAt": "string",37        "rules": "string"38      },39      "status": "active",40      "scopeKind": "all",41      "scopeIds": [42        "string"43      ],44      "signupQuota": 0,45      "budgetFrozen": 0,46      "stats": {47        "signedUp": 0,48        "joined": 0,49        "completed": 0,50        "redeemed": 0,51        "pendingReview": 0,52        "pendingWriteoff": 053      },54      "version": 0,55      "editRules": {56        "locked": [],57        "minQuota": 0,58        "pointsEditable": true,59        "startAtEditable": true,60        "minSignupQuota": 061      }62    }63  ],64  "nextCursor": "string"65}

#管理员：发布前试算预计最高支出与额度池余额

GET/v1/enterprise/org/tasks/budget-preview

鉴权用户态可选

可选。发布页底部的「预计最高支出 / 额度池余额」，与发布同一套算法。编辑时带 taskId（结算方式取任务本身），另返回 delta：本次修改需追加（正）或释放（负）的额度。

查询参数

字段	类型	必填	说明
`settleMode`	string	否	可选值：`reward` / `consume`。默认 `"reward"`
`points`	integer	否	每人额度
`quota`	integer	否	名额；不传 = 不限
`scopeKind`	string	否	可选值：`all` / `departments` / `members`。默认 `"all"`
`scopeIds`	string	否	逗号分隔
`taskId`	string	否	编辑预览时传

返回字段

字段	类型	说明
`maxSpend`	number	预计最高支出；消耗型为 0
`cap`	integer	按名额与范围人数算出的最多发放人数
`poolBalance`	number
`budgetWarn`	string	可能为 null
`delta`	number	仅带 taskId 时返回

错误

400 BAD_REQUEST
404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/org/tasks/budget-preview" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "maxSpend": 0,3  "cap": 0,4  "poolBalance": 0,5  "budgetWarn": "string",6  "delta": 07}

#管理员：任务详情与参与人 / 编辑、提前结束

GETPOST/v1/enterprise/org/tasks/{taskId}

鉴权用户态可选

GET

任务详情与参与人

可选。

路径参数

字段	类型	必填	说明
`taskId`	string	是

返回字段64 个，点击展开

字段	类型	说明
`task`	object	管理视角的任务
`task.id`	string
`task.title`	string
`task.category`	string
`task.categoryLabel`	string
`task.description`	string
`task.coverUrl`	string	可能为 null
`task.settleMode`	string	可选值：`reward` / `consume`
`task.points`	number	每人奖励或消耗的额度（100 = 1 元）
`task.quota`	integer	null = 不限。可能为 null
`task.remaining`	integer	可能为 null
`task.startAt`	string
`task.endAt`	string
`task.phase`	string	可选值：`not_started` / `ongoing` / `ended`
`task.needSignup`	boolean
`task.signupFull`	boolean
`task.completeMode`	string	可选值：`direct` / `submit`
`task.reviewMode`	string	可选值：`auto` / `manual`
`task.needWriteoff`	boolean
`task.scopeText`	string	如「全体员工」「财务部、仓储部」
`task.submitSchema`	object[]
`task.submitSchema[].key`	string
`task.submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`task.submitSchema[].label`	string	最长 20
`task.submitSchema[].required`	boolean
`task.submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`task.pickupInfo`	object	消耗型任务的领取信息
`task.pickupInfo.location`	string
`task.pickupInfo.timeText`	string
`task.pickupInfo.startAt`	string
`task.pickupInfo.endAt`	string
`task.pickupInfo.rules`	string
`task.status`	string	可选值：`active` / `ended` / `cancelled`
`task.scopeKind`	string	可选值：`all` / `departments` / `members`
`task.scopeIds`	string[]
`task.signupQuota`	integer	可能为 null
`task.budgetFrozen`	number	已冻结的预算
`task.stats`	object
`task.stats.signedUp`	integer
`task.stats.joined`	integer
`task.stats.completed`	integer
`task.stats.redeemed`	integer
`task.stats.pendingReview`	integer
`task.stats.pendingWriteoff`	integer
`task.version`	integer	编辑时作为 expectedVersion 带回
`task.editRules`	object	前端据此置灰，服务端照样校验
`task.editRules.locked`	string[]	当前不可改的字段名
`task.editRules.minQuota`	integer
`task.editRules.pointsEditable`	boolean
`task.editRules.startAtEditable`	boolean
`task.editRules.minSignupQuota`	integer
`participants`	object[]
`participants[].member`	object
`participants[].member.accountId`	string
`participants[].member.name`	string
`participants[].member.avatarUrl`	string	可能为 null
`participants[].member.departmentName`	string	可能为 null
`participants[].entry`	object	员工在某个任务上的参与记录
`participants[].entry.id`	string
`participants[].entry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`participants[].entry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`participants[].entry.rewardAmount`	number	可能为 null
`participants[].entry.spentAmount`	number	可能为 null
`participants[].entry.updatedAt`	string

错误

404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业

POST

提前结束 / 编辑任务

可选。action: "end" 提前结束，释放未用预算（待审核的份额先扣留），返回 released。 action: "update" 编辑：带上详情里的 version 作为 expectedVersion（乐观锁），只传要改的字段；结算方式、完成方式、审核方式、是否核销发布后不可改（见 task.editRules.locked）。奖励型改额度 / 名额 / 范围时按差额追加冻结或释放，返回 budgetDelta。

路径参数

字段	类型	必填	说明
`taskId`	string	是

请求体application/json · 发布与编辑任务的字段。消耗型恒为直接完成、自动审核；只有消耗型有核销与领取信息。

字段	类型	必填	说明
`action`	string	是	可选值：`end` / `update`
`expectedVersion`	integer	否	update 时必传
`title`	string	否	最长 30
`description`	string	否	最长 500
`coverUrl`	string	否	封面图 http(s) 地址，发布时必填；用「上传任务封面」拿到
`category`	string	否	奖励型可选 training / learning / survey / activity / other；消耗型可选 festival / daily / activity / other。可选值：`training` / `learning` / `survey` / `activity` / `festival` / `daily` / `other`
`settleMode`	string	否	reward 奖励额度（员工做任务赚）· consume 消耗额度（员工用额度兑换）。可选值：`reward` / `consume`
`points`	integer	否	每人奖励或消耗的额度（100 = 1 元）。≥ 1，≤ 10000000
`quota`	integer	否	名额；不传 = 不限。≥ 1，≤ 100000。可能为 null
`scopeKind`	string	否	可选值：`all` / `departments` / `members`。默认 `"all"`
`scopeIds`	string[]	否	部门 id 或员工平台账号 id（scopeKind 非 all 时必填）
`startAt`	string	否	不传 = 立即开始
`endAt`	string	否	截止时间，必填，须晚于开始时间与现在
`needSignup`	boolean	否
`signupQuota`	integer	否	≥ 1。可能为 null
`completeMode`	string	否	仅奖励型：直接完成 / 提交结果。可选值：`direct` / `submit`。默认 `"direct"`
`reviewMode`	string	否	仅奖励型 + submit：缺省 manual 人工审核。可选值：`auto` / `manual`
`submitSchema`	object[]	否	completeMode = submit 时必填。最多 10 项
`submitSchema[].key`	string	是
`submitSchema[].type`	string	是	可选值：`text` / `image` / `file` / `link`
`submitSchema[].label`	string	是	最长 20
`submitSchema[].required`	boolean	否
`submitSchema[].max`	integer	否	text 字数 / link 长度 / image、file 个数（≤9）上限
`needWriteoff`	boolean	否	仅消耗型：兑换后是否需要线下核销（发领取码）
`pickupInfo`	object	否	消耗型任务的领取信息
`pickupInfo.location`	string	否
`pickupInfo.timeText`	string	否
`pickupInfo.startAt`	string	否
`pickupInfo.endAt`	string	否
`pickupInfo.rules`	string	否

返回字段54 个，点击展开

字段	类型	说明
`task`	object	管理视角的任务
`task.id`	string
`task.title`	string
`task.category`	string
`task.categoryLabel`	string
`task.description`	string
`task.coverUrl`	string	可能为 null
`task.settleMode`	string	可选值：`reward` / `consume`
`task.points`	number	每人奖励或消耗的额度（100 = 1 元）
`task.quota`	integer	null = 不限。可能为 null
`task.remaining`	integer	可能为 null
`task.startAt`	string
`task.endAt`	string
`task.phase`	string	可选值：`not_started` / `ongoing` / `ended`
`task.needSignup`	boolean
`task.signupFull`	boolean
`task.completeMode`	string	可选值：`direct` / `submit`
`task.reviewMode`	string	可选值：`auto` / `manual`
`task.needWriteoff`	boolean
`task.scopeText`	string	如「全体员工」「财务部、仓储部」
`task.submitSchema`	object[]
`task.submitSchema[].key`	string
`task.submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`task.submitSchema[].label`	string	最长 20
`task.submitSchema[].required`	boolean
`task.submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`task.pickupInfo`	object	消耗型任务的领取信息
`task.pickupInfo.location`	string
`task.pickupInfo.timeText`	string
`task.pickupInfo.startAt`	string
`task.pickupInfo.endAt`	string
`task.pickupInfo.rules`	string
`task.status`	string	可选值：`active` / `ended` / `cancelled`
`task.scopeKind`	string	可选值：`all` / `departments` / `members`
`task.scopeIds`	string[]
`task.signupQuota`	integer	可能为 null
`task.budgetFrozen`	number	已冻结的预算
`task.stats`	object
`task.stats.signedUp`	integer
`task.stats.joined`	integer
`task.stats.completed`	integer
`task.stats.redeemed`	integer
`task.stats.pendingReview`	integer
`task.stats.pendingWriteoff`	integer
`task.version`	integer	编辑时作为 expectedVersion 带回
`task.editRules`	object	前端据此置灰，服务端照样校验
`task.editRules.locked`	string[]	当前不可改的字段名
`task.editRules.minQuota`	integer
`task.editRules.pointsEditable`	boolean
`task.editRules.startAtEditable`	boolean
`task.editRules.minSignupQuota`	integer
`poolBalance`	number
`released`	number	end：释放回额度池的额度
`budgetDelta`	number	update：追加（正）或释放（负）的额度

错误

400 BAD_REQUEST / FIELD_LOCKED / QUOTA_TOO_SMALL / TASK_NOT_EDITABLE / POOL_INSUFFICIENT
404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业
409 VERSION_CONFLICT：任务已被他人修改，刷新后重试

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/org/tasks/{taskId}" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "task": {3    "id": "string",4    "title": "string",5    "category": "string",6    "categoryLabel": "string",7    "description": "string",8    "coverUrl": "string",9    "settleMode": "reward",10    "points": 0,11    "quota": 0,12    "remaining": 0,13    "startAt": "string",14    "endAt": "string",15    "phase": "not_started",16    "needSignup": true,17    "signupFull": true,18    "completeMode": "direct",19    "reviewMode": "auto",20    "needWriteoff": true,21    "scopeText": "string",22    "submitSchema": [23      {24        "key": "string",25        "type": "text",26        "label": "string",27        "required": true,28        "max": 029      }30    ],31    "pickupInfo": {32      "location": "string",33      "timeText": "string",34      "startAt": "string",35      "endAt": "string",36      "rules": "string"37    },38    "status": "active",39    "scopeKind": "all",40    "scopeIds": [41      "string"42    ],43    "signupQuota": 0,44    "budgetFrozen": 0,45    "stats": {46      "signedUp": 0,47      "joined": 0,48      "completed": 0,49      "redeemed": 0,50      "pendingReview": 0,51      "pendingWriteoff": 052    },53    "version": 0,54    "editRules": {55      "locked": [56        "string"57      ],58      "minQuota": 0,59      "pointsEditable": true,60      "startAtEditable": true,61      "minSignupQuota": 062    }63  },64  "participants": [65    {66      "member": {67        "accountId": "string",68        "name": "string",69        "avatarUrl": "string",70        "departmentName": "string"71      },72      "entry": {73        "id": "string",74        "status": "signed_up",75        "redeemCode": "string",76        "rewardAmount": 0,77        "spentAmount": 0,78        "updatedAt": "string"79      }80    }81  ]82}

#管理员：上传任务封面

POST/v1/enterprise/org/task-cover

管理员：上传任务封面（先换上传票据，再上传文件）

鉴权用户态可选

可选。两段式上传：先用本接口（签名 JSON）换一张 10 分钟有效、用一次即作废的票据，再把图片 POST multipart（字段名 file）或 PUT 裸 body 到返回的 putPath（凭票据鉴权，不需要签名），得到 { ok, url, key }，把 url 填进任务的 coverUrl。只收 jpg / png / webp，按文件头识别。

请求体application/json

字段	类型	必填	说明
`fileName`	string	否
`contentType`	string	否	例：`image/jpeg`
`size`	integer	否	字节数，超限直接拒

返回字段

字段	类型	说明
`ok`	boolean
`ticket`	string
`putPath`	string	上传地址（相对路径，拼在 API 域名后）
`maxBytes`	integer
`expiresInSec`	integer

错误

400 TOO_LARGE
503 STORAGE_UNAVAILABLE

调用示例

1curl -X POST "https://api.gowu.net/v1/enterprise/org/task-cover" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "ok": true,3  "ticket": "string",4  "putPath": "string",5  "maxBytes": 0,6  "expiresInSec": 07}

#管理员：待审核的提交 / 批量通过或驳回

GETPOST/v1/enterprise/org/task-reviews

管理员：待审核的提交 / 批量通过或驳回（驳回须填原因）

鉴权用户态可选

GET

待审核的提交

可选。员工提交的结果，图片与文件带短时签名链接；task.submitSchema 用来把 payload 渲染成表单。rejected 只列每人最新一版。

查询参数

字段	类型	必填	说明
`status`	string	否	可选值：`pending` / `rejected` / `all`。默认 `"pending"`
`taskId`	string	否
`cursor`	string	否	翻页游标：取上一页返回的 nextCursor，首页不传

返回字段32 个，点击展开

字段	类型	说明
`counts`	object
`counts.all`	integer
`counts.pending`	integer
`counts.rejected`	integer
`items`	object[]
`items[].submission`	object
`items[].submission.id`	string
`items[].submission.version`	integer
`items[].submission.status`	string	可选值：`pending` / `approved` / `rejected` / `superseded`
`items[].submission.payload`	object	text / link 为字符串；image / file 为 [{ key, url, name }]，url 为短时签名链接
`items[].submission.rejectReason`	string	可能为 null
`items[].submission.createdAt`	string
`items[].submission.reviewedAt`	string	可能为 null
`items[].member`	object
`items[].member.accountId`	string
`items[].member.name`	string
`items[].member.avatarUrl`	string	可能为 null
`items[].member.departmentName`	string	可能为 null
`items[].task`	object
`items[].task.id`	string
`items[].task.title`	string
`items[].task.category`	string
`items[].task.categoryLabel`	string
`items[].task.settleMode`	string
`items[].task.points`	number
`items[].task.submitSchema`	object[]
`items[].task.submitSchema[].key`	string
`items[].task.submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`items[].task.submitSchema[].label`	string	最长 20
`items[].task.submitSchema[].required`	boolean
`items[].task.submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`nextCursor`	string	下一页游标；null = 没有下一页。可能为 null

POST

审核通过 / 驳回

可选。批量审核，逐条各自处理：成功的 id 在 ok 数组里，失败的在 failed。通过即发放奖励；驳回必须填原因，员工可重新提交。

请求体application/json

字段	类型	必填	说明
`action`	string	是	可选值：`approve` / `reject`
`submissionIds`	string[]	是
`reason`	string	否	reject 时必填

返回字段

字段	类型	说明
`ok`	string[]	处理成功的 submissionId（注意此处 ok 是数组）
`failed`	object[]
`failed[].id`	string
`failed[].code`	string
`failed[].message`	string

错误

400 BAD_REQUEST：action 不对、没选提交或驳回没填原因

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/org/task-reviews" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "counts": {3    "all": 0,4    "pending": 0,5    "rejected": 06  },7  "items": [8    {9      "submission": {10        "id": "string",11        "version": 0,12        "status": "pending",13        "payload": null,14        "rejectReason": "string",15        "createdAt": "string",16        "reviewedAt": "string"17      },18      "member": {19        "accountId": "string",20        "name": "string",21        "avatarUrl": "string",22        "departmentName": "string"23      },24      "task": {25        "id": "string",26        "title": "string",27        "category": "string",28        "categoryLabel": "string",29        "settleMode": "string",30        "points": 0,31        "submitSchema": []32      }33    }34  ],35  "nextCursor": "string"36}

#管理员：待核销兑换

GETPOST/v1/enterprise/org/task-redemptions

管理员：待核销兑换（可按码查）/ 核销或撤销（撤销退额度）

鉴权用户态可选

GET

兑换核销列表 / 按领取码查

可选。消耗型任务的兑换记录。缺省列待核销的；带 code 时按领取码查（查不到 items 为空）。

查询参数

字段	类型	必填	说明
`status`	string	否	entry 状态，如 pending_writeoff / completed / refunded / all；缺省 pending_writeoff（带 code 时缺省 all）
`code`	string	否	领取码
`cursor`	string	否	翻页游标：取上一页返回的 nextCursor，首页不传

返回字段26 个，点击展开

字段	类型	说明
`items`	object[]
`items[].entry`	object	员工在某个任务上的参与记录
`items[].entry.id`	string
`items[].entry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`items[].entry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`items[].entry.rewardAmount`	number	可能为 null
`items[].entry.spentAmount`	number	可能为 null
`items[].entry.updatedAt`	string
`items[].member`	object
`items[].member.accountId`	string
`items[].member.name`	string
`items[].member.avatarUrl`	string	可能为 null
`items[].member.departmentName`	string	可能为 null
`items[].task`	object
`items[].task.id`	string
`items[].task.title`	string
`items[].task.coverUrl`	string	可能为 null
`items[].task.points`	number
`items[].task.pickupInfo`	object	消耗型任务的领取信息
`items[].task.pickupInfo.location`	string
`items[].task.pickupInfo.timeText`	string
`items[].task.pickupInfo.startAt`	string
`items[].task.pickupInfo.endAt`	string
`items[].task.pickupInfo.rules`	string
`items[].redeemedAt`	string
`nextCursor`	string	下一页游标；null = 没有下一页。可能为 null

POST

核销 / 撤销兑换

可选。writeoff 核销（员工线下领取后）；revoke 撤销兑换，额度退回员工、名额回补。用 entryId 或 code 指定。

请求体application/json

字段	类型	必填	说明
`action`	string	是	可选值：`writeoff` / `revoke`
`entryId`	string	否
`code`	string	否	领取码；与 entryId 二选一

返回字段

字段	类型	说明
`entry`	object	员工在某个任务上的参与记录
`entry.id`	string
`entry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`entry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`entry.rewardAmount`	number	可能为 null
`entry.spentAmount`	number	可能为 null
`entry.updatedAt`	string

错误

400 BAD_REQUEST / INVALID_CODE / INVALID_STATE
404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/org/task-redemptions" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "items": [3    {4      "entry": {5        "id": "string",6        "status": "signed_up",7        "redeemCode": "string",8        "rewardAmount": 0,9        "spentAmount": 0,10        "updatedAt": "string"11      },12      "member": {13        "accountId": "string",14        "name": "string",15        "avatarUrl": "string",16        "departmentName": "string"17      },18      "task": {19        "id": "string",20        "title": "string",21        "coverUrl": "string",22        "points": 0,23        "pickupInfo": {}24      },25      "redeemedAt": "string"26    }27  ],28  "nextCursor": "string"29}

#员工：可参与的任务

GET/v1/enterprise/tasks

员工：可参与的任务（?tab=earn|redeem）

鉴权用户态可选

出现在员工福利 · 福豆任务、签到与生日

可选。tab=earn 赚额度（奖励型）· tab=redeem 兑福利（消耗型）。只返回本人范围内、进行中的任务，带 myEntry。每页 20 条。

查询参数

字段	类型	必填	说明
`tab`	string	否	可选值：`earn` / `redeem`。默认 `"earn"`
`cursor`	string	否	翻页游标：取上一页返回的 nextCursor，首页不传

返回字段49 个，点击展开

字段	类型	说明
`items`	object[]
`items[].id`	string
`items[].title`	string
`items[].category`	string
`items[].categoryLabel`	string
`items[].description`	string
`items[].coverUrl`	string	可能为 null
`items[].settleMode`	string	可选值：`reward` / `consume`
`items[].points`	number	每人奖励或消耗的额度（100 = 1 元）
`items[].quota`	integer	null = 不限。可能为 null
`items[].remaining`	integer	可能为 null
`items[].startAt`	string
`items[].endAt`	string
`items[].phase`	string	可选值：`not_started` / `ongoing` / `ended`
`items[].needSignup`	boolean
`items[].signupFull`	boolean
`items[].completeMode`	string	可选值：`direct` / `submit`
`items[].reviewMode`	string	可选值：`auto` / `manual`
`items[].needWriteoff`	boolean
`items[].scopeText`	string	如「全体员工」「财务部、仓储部」
`items[].submitSchema`	object[]
`items[].submitSchema[].key`	string
`items[].submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`items[].submitSchema[].label`	string	最长 20
`items[].submitSchema[].required`	boolean
`items[].submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`items[].pickupInfo`	object	消耗型任务的领取信息
`items[].pickupInfo.location`	string
`items[].pickupInfo.timeText`	string
`items[].pickupInfo.startAt`	string
`items[].pickupInfo.endAt`	string
`items[].pickupInfo.rules`	string
`items[].myEntry`	object	员工在某个任务上的参与记录
`items[].myEntry.id`	string
`items[].myEntry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`items[].myEntry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`items[].myEntry.rewardAmount`	number	可能为 null
`items[].myEntry.spentAmount`	number	可能为 null
`items[].myEntry.updatedAt`	string
`items[].lastSubmission`	object	仅详情接口返回
`items[].lastSubmission.id`	string
`items[].lastSubmission.version`	integer
`items[].lastSubmission.status`	string	可选值：`pending` / `approved` / `rejected` / `superseded`
`items[].lastSubmission.payload`	object	text / link 为字符串；image / file 为 [{ key, url, name }]，url 为短时签名链接
`items[].lastSubmission.rejectReason`	string	可能为 null
`items[].lastSubmission.createdAt`	string
`items[].lastSubmission.reviewedAt`	string	可能为 null
`nextCursor`	string	下一页游标；null = 没有下一页。可能为 null
`balance`	number	员工当前额度余额

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/tasks" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "items": [3    {4      "id": "string",5      "title": "string",6      "category": "string",7      "categoryLabel": "string",8      "description": "string",9      "coverUrl": "string",10      "settleMode": "reward",11      "points": 0,12      "quota": 0,13      "remaining": 0,14      "startAt": "string",15      "endAt": "string",16      "phase": "not_started",17      "needSignup": true,18      "signupFull": true,19      "completeMode": "direct",20      "reviewMode": "auto",21      "needWriteoff": true,22      "scopeText": "string",23      "submitSchema": [24        {}25      ],26      "pickupInfo": {27        "location": "string",28        "timeText": "string",29        "startAt": "string",30        "endAt": "string",31        "rules": "string"32      },33      "myEntry": {34        "id": "string",35        "status": "signed_up",36        "redeemCode": "string",37        "rewardAmount": 0,38        "spentAmount": 0,39        "updatedAt": "string"40      },41      "lastSubmission": {42        "id": "string",43        "version": 0,44        "status": "pending",45        "payload": null,46        "rejectReason": "string",47        "createdAt": "string",48        "reviewedAt": "string"49      }50    }51  ],52  "nextCursor": "string",53  "balance": 054}

#员工：我参与的任务 / 我的兑换

GET/v1/enterprise/tasks/mine

鉴权用户态可选

可选。参与过的任务，按最近变动倒序，每页 20 条。

查询参数

字段	类型	必填	说明
`kind`	string	否	可选值：`earn` / `redeem`。默认 `"earn"`
`cursor`	string	否	翻页游标：取上一页返回的 nextCursor，首页不传

返回字段56 个，点击展开

字段	类型	说明
`items`	object[]
`items[].task`	object	员工视角的任务
`items[].task.id`	string
`items[].task.title`	string
`items[].task.category`	string
`items[].task.categoryLabel`	string
`items[].task.description`	string
`items[].task.coverUrl`	string	可能为 null
`items[].task.settleMode`	string	可选值：`reward` / `consume`
`items[].task.points`	number	每人奖励或消耗的额度（100 = 1 元）
`items[].task.quota`	integer	null = 不限。可能为 null
`items[].task.remaining`	integer	可能为 null
`items[].task.startAt`	string
`items[].task.endAt`	string
`items[].task.phase`	string	可选值：`not_started` / `ongoing` / `ended`
`items[].task.needSignup`	boolean
`items[].task.signupFull`	boolean
`items[].task.completeMode`	string	可选值：`direct` / `submit`
`items[].task.reviewMode`	string	可选值：`auto` / `manual`
`items[].task.needWriteoff`	boolean
`items[].task.scopeText`	string	如「全体员工」「财务部、仓储部」
`items[].task.submitSchema`	object[]
`items[].task.submitSchema[].key`	string
`items[].task.submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`items[].task.submitSchema[].label`	string	最长 20
`items[].task.submitSchema[].required`	boolean
`items[].task.submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`items[].task.pickupInfo`	object	消耗型任务的领取信息
`items[].task.pickupInfo.location`	string
`items[].task.pickupInfo.timeText`	string
`items[].task.pickupInfo.startAt`	string
`items[].task.pickupInfo.endAt`	string
`items[].task.pickupInfo.rules`	string
`items[].task.myEntry`	object	员工在某个任务上的参与记录
`items[].task.myEntry.id`	string
`items[].task.myEntry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`items[].task.myEntry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`items[].task.myEntry.rewardAmount`	number	可能为 null
`items[].task.myEntry.spentAmount`	number	可能为 null
`items[].task.myEntry.updatedAt`	string
`items[].task.lastSubmission`	object	仅详情接口返回
`items[].task.lastSubmission.id`	string
`items[].task.lastSubmission.version`	integer
`items[].task.lastSubmission.status`	string	可选值：`pending` / `approved` / `rejected` / `superseded`
`items[].task.lastSubmission.payload`	object	text / link 为字符串；image / file 为 [{ key, url, name }]，url 为短时签名链接
`items[].task.lastSubmission.rejectReason`	string	可能为 null
`items[].task.lastSubmission.createdAt`	string
`items[].task.lastSubmission.reviewedAt`	string	可能为 null
`items[].entry`	object	员工在某个任务上的参与记录
`items[].entry.id`	string
`items[].entry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`items[].entry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`items[].entry.rewardAmount`	number	可能为 null
`items[].entry.spentAmount`	number	可能为 null
`items[].entry.updatedAt`	string
`nextCursor`	string	下一页游标；null = 没有下一页。可能为 null

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/tasks/mine" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "items": [3    {4      "task": {5        "id": "string",6        "title": "string",7        "category": "string",8        "categoryLabel": "string",9        "description": "string",10        "coverUrl": "string",11        "settleMode": "reward",12        "points": 0,13        "quota": 0,14        "remaining": 0,15        "startAt": "string",16        "endAt": "string",17        "phase": "not_started",18        "needSignup": true,19        "signupFull": true,20        "completeMode": "direct",21        "reviewMode": "auto",22        "needWriteoff": true,23        "scopeText": "string",24        "submitSchema": [],25        "pickupInfo": {},26        "myEntry": {},27        "lastSubmission": {}28      },29      "entry": {30        "id": "string",31        "status": "signed_up",32        "redeemCode": "string",33        "rewardAmount": 0,34        "spentAmount": 0,35        "updatedAt": "string"36      }37    }38  ],39  "nextCursor": "string"40}

#员工：任务详情 / 报名、完成、提交、兑换

GETPOST/v1/enterprise/tasks/{taskId}

员工：任务详情 / 报名、完成、提交、兑换（带 idempotencyKey）

鉴权用户态可选

GET

任务详情

可选。含我的参与记录与最近一次提交（含驳回原因）。

路径参数

字段	类型	必填	说明
`taskId`	string	是

返回字段48 个，点击展开

字段	类型	说明
`task`	object	员工视角的任务
`task.id`	string
`task.title`	string
`task.category`	string
`task.categoryLabel`	string
`task.description`	string
`task.coverUrl`	string	可能为 null
`task.settleMode`	string	可选值：`reward` / `consume`
`task.points`	number	每人奖励或消耗的额度（100 = 1 元）
`task.quota`	integer	null = 不限。可能为 null
`task.remaining`	integer	可能为 null
`task.startAt`	string
`task.endAt`	string
`task.phase`	string	可选值：`not_started` / `ongoing` / `ended`
`task.needSignup`	boolean
`task.signupFull`	boolean
`task.completeMode`	string	可选值：`direct` / `submit`
`task.reviewMode`	string	可选值：`auto` / `manual`
`task.needWriteoff`	boolean
`task.scopeText`	string	如「全体员工」「财务部、仓储部」
`task.submitSchema`	object[]
`task.submitSchema[].key`	string
`task.submitSchema[].type`	string	可选值：`text` / `image` / `file` / `link`
`task.submitSchema[].label`	string	最长 20
`task.submitSchema[].required`	boolean
`task.submitSchema[].max`	integer	text 字数 / link 长度 / image、file 个数（≤9）上限
`task.pickupInfo`	object	消耗型任务的领取信息
`task.pickupInfo.location`	string
`task.pickupInfo.timeText`	string
`task.pickupInfo.startAt`	string
`task.pickupInfo.endAt`	string
`task.pickupInfo.rules`	string
`task.myEntry`	object	员工在某个任务上的参与记录
`task.myEntry.id`	string
`task.myEntry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`task.myEntry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`task.myEntry.rewardAmount`	number	可能为 null
`task.myEntry.spentAmount`	number	可能为 null
`task.myEntry.updatedAt`	string
`task.lastSubmission`	object	仅详情接口返回
`task.lastSubmission.id`	string
`task.lastSubmission.version`	integer
`task.lastSubmission.status`	string	可选值：`pending` / `approved` / `rejected` / `superseded`
`task.lastSubmission.payload`	object	text / link 为字符串；image / file 为 [{ key, url, name }]，url 为短时签名链接
`task.lastSubmission.rejectReason`	string	可能为 null
`task.lastSubmission.createdAt`	string
`task.lastSubmission.reviewedAt`	string	可能为 null
`balance`	number

错误

404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业

POST

报名 / 完成 / 提交 / 兑换

可选。signup 报名 · complete 直接完成（发奖励）· submit 提交结果（payload 按任务 submitSchema 组织：text / link 填字符串，image / file 填 [{ key, name }]，key 来自「上传任务凭证」）· redeem 用额度兑换（消耗型）。重复操作返回第一次的结果。

路径参数

字段	类型	必填	说明
`taskId`	string	是

请求体application/json

字段	类型	必填	说明
`action`	string	是	可选值：`signup` / `complete` / `submit` / `redeem`
`payload`	object	否	仅 submit：键为 submitSchema[].key
`idempotencyKey`	string	否

返回字段

字段	类型	说明
`entry`	object	员工在某个任务上的参与记录
`entry.id`	string
`entry.status`	string	可选值：`signed_up` / `in_progress` / `submitted` / `rejected` / `completed` / `pending_writeoff` / `refunded` / `expired`
`entry.redeemCode`	string	需核销的兑换才有领取码。可能为 null
`entry.rewardAmount`	number	可能为 null
`entry.spentAmount`	number	可能为 null
`entry.updatedAt`	string
`balance`	number	操作后余额
`rewarded`	number	本次获得的额度
`spent`	number	本次消耗的额度

错误

400 TASK_NOT_STARTED / TASK_ENDED / SIGNUP_REQUIRED / SIGNUP_FULL / QUOTA_FULL / INSUFFICIENT_POINTS / ALREADY_DONE / INVALID_STATE / BAD_REQUEST
404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业

调用示例

1curl -X GET "https://api.gowu.net/v1/enterprise/tasks/{taskId}" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001"

返回示例

1{2  "task": {3    "id": "string",4    "title": "string",5    "category": "string",6    "categoryLabel": "string",7    "description": "string",8    "coverUrl": "string",9    "settleMode": "reward",10    "points": 0,11    "quota": 0,12    "remaining": 0,13    "startAt": "string",14    "endAt": "string",15    "phase": "not_started",16    "needSignup": true,17    "signupFull": true,18    "completeMode": "direct",19    "reviewMode": "auto",20    "needWriteoff": true,21    "scopeText": "string",22    "submitSchema": [23      {24        "key": "string",25        "type": "text",26        "label": "string",27        "required": true,28        "max": 029      }30    ],31    "pickupInfo": {32      "location": "string",33      "timeText": "string",34      "startAt": "string",35      "endAt": "string",36      "rules": "string"37    },38    "myEntry": {39      "id": "string",40      "status": "signed_up",41      "redeemCode": "string",42      "rewardAmount": 0,43      "spentAmount": 0,44      "updatedAt": "string"45    },46    "lastSubmission": {47      "id": "string",48      "version": 0,49      "status": "pending",50      "payload": null,51      "rejectReason": "string",52      "createdAt": "string",53      "reviewedAt": "string"54    }55  },56  "balance": 057}

#员工：上传任务凭证

POST/v1/enterprise/task-proof

员工：上传任务凭证（先换上传票据，再上传文件）

鉴权用户态可选

可选。两段式上传：先用本接口（签名 JSON）换一张 10 分钟有效的票据，再把文件 POST multipart（字段名 file）或 PUT 裸 body 到返回的 putPath（凭票据鉴权，不需要签名），得到 { ok, key, url, name }。提交任务时 payload 里传 { key, name }；url 是短时签名链接，只用于立即预览。支持 jpg / png / webp 图片（≤10MB）与 pdf / doc(x) / xls(x) 文件（≤20MB），按文件头识别。

请求体application/json

字段	类型	必填	说明
`taskId`	string	是
`fileName`	string	否	Office 文件靠后缀区分格式，建议带上
`contentType`	string	否	image/* 按图片限额，其余按文件限额
`size`	integer	否	字节数，超限直接拒

返回字段

字段	类型	说明
`ok`	boolean
`ticket`	string
`putPath`	string	上传地址（相对路径，拼在 API 域名后）
`maxBytes`	integer
`expiresInSec`	integer

错误

400 BAD_REQUEST 缺 taskId / TOO_LARGE / INVALID_STATE 该任务无需提交凭证 / TASK_ENDED
404 TASK_NOT_FOUND：任务不存在、已下架或不属于本企业
503 STORAGE_UNAVAILABLE

调用示例

1curl -X POST "https://api.gowu.net/v1/enterprise/task-proof" \2  -H "x-app-key: $GOWU_APP_KEY" \3  -H "x-timestamp: $TS" \4  -H "x-nonce: $NONCE" \5  -H "x-sign-version: 2" \6  -H "x-signature: $SIG" \7  -H "x-open-user: u-001" \8  -H "content-type: application/json" \9  -d '{"taskId":"string"}'

返回示例

1{2  "ok": true,3  "ticket": "string",4  "putPath": "string",5  "maxBytes": 0,6  "expiresInSec": 07}