Badges
A qualification or skill that is required to accept a particular Job Request
A Badge represents a qualification or skill that a Worker can acquire and which can be specified as required for a particular Job Request.
If a Job Request specifies that Badges are required, only those Workers who posess all the specified Badges will see the Job Request and be able to Accept it.
Supported Formats
json
GET /api_v2/badges
List available Badges
Returns a list of available Badges, optionally paginated. Note: the maximum number returned per page in any case is 50.
Supported Formats
jsonErrors
Code | Description |
---|---|
401 | Unauthorized |
Examples
curl -v -d "token=HdgXqxYWd5tTdyabzfzo" http://api.wonolo.com/api_v2/badges
curl -v -d "token=HdgXqxYWd5tTdyabzfzo" http://api.wonolo.com/api_v2/badges?page=10&per=25
curl -v -d "token=HdgXqxYWd5tTdyabzfzo" http://api.wonolo.com/api_v2/badges?query=test
Params
Param name | Description |
---|---|
token
required |
Token obtained from /authorize Validations:
|
page
optional |
The page number to start from Validations:
|
per
optional |
The size of the page Validations:
|
query
optional |
Filter by name of badge Validations:
|
GET /api_v2/badges/:id
Get a specific Badge
Supported Formats
jsonParams
Param name | Description |
---|---|
token
required |
Token obtained from /authorize Validations:
|
POST /api_v2/badges
Create a new Badge
Supported Formats
jsonParams
Param name | Description |
---|---|
token
required |
Token obtained from /authorize Validations:
|
badge
required |
Validations:
|
badge[name]
required |
Name of Badge Validations:
|
badge[description]
required |
Description of Badge Detail Validations:
|
badge[info_url]
optional |
External Url for more Information about Badge Validations:
|
badge[remote_icon_url]
optional |
Remote URL of Icon Image Validations:
|
badge[is_soft]
optional |
Allow Wonoloers to be ranked/notified about a job even though they do not have the badge Validations:
|
PATCH /api_v2/badges/:id
Update a Badge
Supported Formats
jsonParams
Param name | Description |
---|---|
token
required |
Token obtained from /authorize Validations:
|
badge
required |
Validations:
|
badge[name]
required |
Name of Badge Validations:
|
badge[description]
required |
Description of Badge Detail Validations:
|
badge[info_url]
optional |
External Url for more Information about Badge Validations:
|
badge[remote_icon_url]
optional |
Remote URL of Icon Image Validations:
|
badge[is_soft]
optional |
Allow Wonoloers to be ranked/notified about a job even though they do not have the badge Validations:
|
DELETE /api_v2/badges/:id
Delete a Badge
Supported Formats
jsonParams
Param name | Description |
---|---|
token
required |
Token obtained from /authorize Validations:
|