POST /jobs (发布任务)
介绍
本 API 让请求者发布一个新的集智任务。这个集智任务将被展示在我们的平台上,有兴趣的工作者即可以接受并完成这个任务。
我们提供三种不同的方式让请求者定制自己的任务:
内部问题表单 (InternalQuestionsForm):使用集智的语法,用 JSON 的形式直接定义任务中的问题。
外部问题表单 (ExternalQuestionsForm):将问题放在你自己的网站上,提供 link 由我们呈现在集智的平台上。
HTML问题表单 (HTMLQuestionsForm):将问题的内容以 HTML 字串的形式传入。
指定任务类型
在发布任务时,请求者可以选择指定任务类型,让相同任务类型的任务聚集起来,方便工作者做大量类似的任务。当请求者指定任务类型时,本任务的 title, description, reward, keywords, taskDuration, lifetime, maxTasks, 和 autoApprovalDelay 均会继承任务类型设定的内容。除了 maxTasks 之外,均无法更改。
HTTP Request
URL
https://api.crowdsdom.com/v1/jobs
HTTP Method
POST
HTTP Header
Content-Type: application/json
Authorization: YOUR_ACCESS_TOKEN
参数
Body
以下的参数在 http 请求的 Body 中以 JSON 的格式传入。
名称 | 描述 | Type | Default | Required |
---|---|---|---|---|
title | 工作者看到的任务标题。 | String | None | Yes |
description | 介绍该任务的简短描述。 | String | None | Yes |
jobTypeId | 任务的任务类型之专属识别号,定义了任务的 title, description, reward, keywords, taskDuration, lifetime, maxTasks, 和 autoApprovalDelay。 当请求者指定了任务类型,以上这些栏位均变为非必填。除了 maxTasks 之外,均无法在本请求中更改。 |
String | None | No |
questionsType | 任务发布的方式,必须符合三种预设的方式之一。 详情请见任务问题表单的数据结构。 |
String | None | Yes |
internalQuestionsForm | 内部问题表单 | Object | None | No |
externalQuestionsForm | 外部问题表单 | Object | None | No |
htmlQuestionsForm | HTML问题表单 | Object | None | No |
reward | 工作者完成任务能得到的酬劳,由 amount 与 currencyCode 组成。amount 是指酬劳的金额,currencyCode 则是币种。 范例:若想设定酬劳为¥0.1,则应该在 reward 传入:{“amount” : 0.10, “currencyCode”: “CNY”} |
Object | None | Yes |
keywords | 让工作者更易搜索到该任务的关键词 (组)。 若有超过一个关键词,用逗号隔开。 |
String | None | No |
lifetime | 任务失效的时间 (秒),失效后任何工作者均无法接受该任务。 最小值: 600(10 分钟),最大值:2592000(30天) |
Integer | 604800 | No |
taskDuration | 工作者接受指定工作后,必须完成任务的时间 (秒) 最小值:300(5分钟),最大值:86400(1天) |
Integer | 300 | No |
maxTasks | 能够接受该任务的工作者数量 最小值:1,最大值:10000 |
Integer | 1 | No |
autoAprrovalDelay | 系统自动批准工作结果的时间 (秒)。若在这段时间内请求者没有主动拒绝,则视为该工作被接受 最小值:0 (立即接受),最大值:2592000(30天) |
Integer | 86400 | No |
回复
若 http request 成功发布任务(status code: 200),系统将会返回已发布的集智任务(Job),详情请见集智任务的数据结构。若没成功,系统则会返回错误的代码及原因。
扫描二维码关注公众号,回复:
7453240 查看本文章
示例
以Python requests 直接调用 API 接口为例:
请求
1 |
|
回复
1 |
{ |