POST /jobTypes (创建任务类型)

介绍

本 API 让请求者创建一个新的任务类型。任务类型定义了集智任务的重要属性如标题、报酬等。在工作者接受任务的界面上,相同任务类型的任务将被聚集起来。工作者完成一个任务后即会自动接受相同任务类型的下一个任务。请求者如果需要工作者完成大量的工作(如:标注100张图片),在发布任务时便可以将这些任务指定相同的任务类型,方便工作者更快速完成大量的工作。

HTTP Request

URL

https://api.crowdsdom.com/v1/jobTypes

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
reward 任务类型定义的工作报酬 Object None Yes
keywords 任务类型定义的任务关键词 String None No
taskDuration 任务类型定义的工作者工作时间 (秒) Integer 300 No
lifetime 任务类型定义的任务失效时间 (秒) Integer 604800 No
maxTasks 任务类型定义能够接受该任务的工作者数量 Integer 1 No
autoApprovalDelay 此任务类型定义系统自动批准工作结果的时间 (秒) Integer 86400 No

示例

以Python requests 直接调用 API 接口为例:

请求

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# -*- encoding: utf-8 -*-
import json
import requests

API_URL = "https://api.crowdsdom.com/v1/jobTypes"

headers = {
"Authorization": "YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"}

job_settings = {
"title":"微博情感分析",
"description":"判断博文中所表达的情绪",
"keywords": ["情感分析","微博"],
"reward": {"amount": 0.1, "currencyCode": "CNY"}
}

data = json.dumps(job_settings)

response = requests.post(API_URL, headers=headers, data=data)

回复

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
"id": "507f191e810c19729de860ea",
"description": "判断博文中所表达的情绪",
"title": "微博情感分析",
"keywords": [
"情感分析",
"微博"
],
"lifetime": 604800,
"taskDuration": 300,
"maxTasks": 3,
"autoApprovalDelay": 86400,
"reward": {
"amount": 0.1,
"formattedPrice": "0.1元"
},
"createdAt": "2015-09-23T05:42:31.565Z",
"updatedAt": "2015-09-23T05:42:31.567Z",
"ownerId": "55fffdbc220c681700f5eaca"
}