Judgments
A Judgment represents data collected from our labor pool. Each Unit can have multiple Judgments. An aggregate structure can be queried with meta information, and the best answer is chosen from multiple Judgments.
Attributes
Read / Write
- reviewed
- missed
- data
- tainted
- country
- region
- city
Read-only
- started_at
- created_at
- job_id
- worker_id
- unit_id
- judgment
- external_type
- rejected
- ip
- id
Methods
Common
| Action | URL / Params | Verb |
|---|---|---|
| Create | /jobs/:job_id/judgments | POST |
| Read | /jobs/:job_id/judgments/:judgment_id | GET |
| Update | /jobs/:job_id/judgments/:judgment_id | PUT |
| Delete | /jobs/:job_id/judgments/:judgment_id | DELETE |
Parameters
Create and Update both accept the Read / Write attributes listed above. Be sure to prepend “judgment” to each url parameter, e.g.
judgment[data][some_key]=Some+valueRead accepts a :limit and :page property. See “Reading judgments” below.
Bulk Download
A CSV of all judgments collected for a given job is available.
| Action | URL / Params | Verb |
|---|---|---|
| Download | /jobs/:job_id.csv | GET |
Parameters
- full
- If set to
true, each row in the generated csv will represent one unit (default). If set tofalse, each row will represent a single unit with the best answer chosen by our aggregation logic.
Response
It can take up to a minute to generate a bulk download, depending on the point in the job cycle that you make the request. If we need to generate or re-generate the CSV for you, the status of the response will be 202 and the body will be as follows.
{
"notice":
{"message": "Your CSV is being generated. Try again in 10 seconds."}
}