-
Notifications
You must be signed in to change notification settings - Fork 27
API Overview
Pablo Targa edited this page Jan 28, 2019
·
9 revisions
- Introduction
- Current Base URL
- Swagger Specification
- Test Client
- Endpoint Description
- API Usage
-
Endpoints Usage
- Job Title Autocomplete
- Normalize Job Title
- Get Job Titles from O*NET Code
- Skill Name Autocomplete
- Normalize Skill Name
- Get Normalized Skill uuid from Skill_ONET ID
- Get Associated Skills for a Job
- Get Associated Jobs for a Job
- Get Associated Jobs for a Skill
- Get Associated Skills for a Skill
- Get Skills Name and frequency for a Skill UUID
- Get Job Name for a Job UUID
- Retrieve all Jobs
- Retrieve all Skills
The purpose of this wiki page is to provide a central point for communicating the architecture of the Open Skills API and soliciting feedback from stakeholders.
The base URL for the most recent version of the API can be found at: http://api.dataatwork.org/v1/
Swagger specification is available at: http://api.dataatwork.org/v1/spec/skills-api.json
A simple test client using Swagger UI is available at: http://api.dataatwork.org/v1/spec/
The endpoints shown here are a duplication of the current endpoints targeted for the minimally viable product (MVP). Please refer to the canonical API document found here.
| ID | Endpoint | Description | Data Source |
|---|---|---|---|
| 1 | /jobs/autocomplete | Job title autocomplete | jobs_master.tsv |
| 2 | /jobs/normalize | Normalize job title | Not yet available |
| 3 | /jobs/<onet_soc_code> | Job title from O*Net SOC code | jobs_master.tsv |
| 4 | /skills/autocomplete | Skill name autocomplete | skills_master.tsv |
| 5 | /skills/normalize | Normalize skill name | Not yet available |
| 6 | /skills/<onet_soc_code> | Normalized skill uuid from skill O*Net SOC code | skills_master.tsv |
| 7 | /jobs/<uuid>/related_skills/ | Associated skills for a job | skills_master.tsv |
| jobs_master.tsv | |||
| 8 | /jobs/<uuid>/related_jobs | Associated jobs for a job | jobs_master.tsv |
| 9 | /skills/<uuid>/related_jobs | Associated jobs for a skill | skills_master.tsv |
| jobs_master.tsv | |||
| 10 | /skills/<uuid>/related_skills | Associated skills for a skill | skills_master.tsv |
| 11 | /skills/<uuid> | Name and frequency for a skill uuid | skills_master.tsv |
| 12 | /jobs/<uuid> | Job name from a job uuid | jobs_master.tsv |
| 13 | /jobs | Lists the UUIDs and titles for all jobs. | jobs_master.tsv |
| 14 | /skills | Lists the UUIDs and names for all skills | skills_master.tsv |
The current version of the API only support JSON objects for requests and responses. Other request and response types such as XML may be supported in the future.
The present version of the API does not require any kind of user auth (to be implemented in a future sprint); however, users are able to request resources via any of the following three methods:
- Specify the API version number by the endpoint:
curl -X GET /path/to/api/v1/skills
- Specify a custom header
api-versionas a part of the request:
curl -H "api-version: 1" -X GET /path/to/api/skills
- Specify the version number a part of the
Acceptheader:
curl -H "Accept: application/vnd.openskills.v1+json" -X GET /path/to/api/skills"
Note that the URL redirects for handling the redirects to the appropriate API version via headers requires further configuration before being made active. For testing purposes, users are encouraged to use the first method shown.
- Purpose: Allows autocompletion of a job title as a user is typing.
- Input: Job title fragment (string)
- Output: Full (array) of canonical jobs containing the given fragment including titles (strings) and job uuids (hash)
- Methods: GET
- Note: This helps ensure consistency in job titles that are entered to help with getting associated skills and jobs for a particular job that is entered.
| Status | Description |
|---|---|
| 200 | Successfully found a collection of job titles matching the given string. |
| 400 | Bad request (i.e. forgotten to specify a parameter or incorrect parameter provided.) |
| 404 | Unable to find any job titles that match the given string. |
curl -X GET /path/to/api/v1/jobs/autocomplete?begins_with="software"
[
{
"uuid" : "6f7990802a8bd0e8f09ad8b22e06efb1",
"suggestion" : "software publisher",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"uuid" : "0ed00d0028c57b9d27fbb7f295051d73",
"suggestion" : "software project manager",
"parent_uuid" : "0af6dbafc69717d8938e5d9b6149f865"
},
{
"uuid" : "46a67fb3e8962b5eed7b9c1b41304792",
"suggestion" : "software trainer",
"parent_uuid" : "ad9935df1f6da4e4273ccef9ed9c2f66"
},
{
"uuid" : "b80b193730dd7c794cf834372f8c4aee",
"suggestion" : "software development engineer",
"parent_uuid" : "2afa09d9c7f2fbad823a2fe2df52e58f"
},
{
"uuid" : "6eec3fb9c48291bcf74f844eb809b078",
"suggestion" : "software engineer",
"parent_uuid" : "2afa09d9c7f2fbad823a2fe2df52e58f"
}
]
curl -X GET /path/to/api/v1/jobs/autocomplete?contains="software"
[
{
"uuid" : "6f7990802a8bd0e8f09ad8b22e06efb1",
"suggestion" : "software publisher",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"uuid" : "c0bc880b0d027fb2816e504fd9e54f40",
"suggestion" : "network software manager",
"parent_uuid" : "0af6dbafc69717d8938e5d9b6149f865"
},
{
"uuid" : "b3a3b44c23fe170f67271a116e010251",
"suggestion" : "programming and software development project manager",
"parent_uuid" : "0af6dbafc69717d8938e5d9b6149f865"
},
{
"uuid" : "0ed00d0028c57b9d27fbb7f295051d73",
"suggestion" : "software project manager",
"parent_uuid" : "0af6dbafc69717d8938e5d9b6149f865"
},
{
"uuid" : "46a67fb3e8962b5eed7b9c1b41304792",
"suggestion" : "software trainer",
"parent_uuid" : "ad9935df1f6da4e4273ccef9ed9c2f66"
}
]
curl -X GET /path/to/api/v1/jobs/autocomplete?ends_with="manager"
[
{
"uuid" : "f5070ef1b6d5df945b1ae4205fc91fb2",
"suggestion" : "bakery manager",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"uuid" : "dfde855a9e92322b8e062ba836eb9800",
"suggestion" : "brokerage office manager",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"uuid" : "36af3005f0c455198c83023ebe71e2e1",
"suggestion" : "cemetery manager",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"uuid" : "28c536fd4620eeaf075dd246da52fd66",
"suggestion" : "city manager",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"uuid" : "c2b293b729f8b611bfdf8912b28798e8",
"suggestion" : "corporate manager",
"parent_uuid" : "0e9d360ea7be561208352600e287333b"
}
]
- Purpose: To find the canonical job title (like “Baker”) for an entered synonymous job title (like “Cupcake ninja”)
- Input: Arbitrary synonymous job title (string)
- Output: Canonical job title (string) and uuid (hash)
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of job titles matching the given string. |
| 400 | Bad request (i.e. forgotten to specify a parameter or incorrect parameter provided.) |
| 404 | Unable to find any job titles that match the given string. |
Retrieve a collection of "unusual" job titles based on a partial or full match of a specified title.
curl -X GET /path/to/api/v1/jobs/normalize?job_title="ninja"
[
{
"description" : "financial manager",
"parent_uuid" : "90369dd177d9dc5305079b81f1dc0702",
"uuid" : "9ffbfbe0c0f711a4b5c09cb9489dffa0",
"title" : "accounting ninja"
},
{
"description" : "sales executive",
"parent_uuid" : "193e2cfef58673322b3e112004e22464",
"uuid" : "1a53001559d3244c7825e01f5bf47053",
"title" : "sales ninja"
},
{
"description" : "customer service or social media",
"parent_uuid" : "be9577e912d72645481316acfcdafa66",
"uuid" : "4fc168e1113b1f26cc2df5bba8e4d731",
"title" : "customer engagement ninja"
},
{
"description" : "software engineer",
"parent_uuid" : "d202138ac2ddca18189dd7464b395a61",
"uuid" : "1254c7d8dda6756e1094a040d5724675",
"title" : "software ninjaneer"
},
{
"description" : "web application developer",
"parent_uuid" : "292316eb40b9c152340ae42d7b2816f7",
"uuid" : "a50d6a27ebeaa857a184fce80c6e37cc",
"title" : "php ninja"
},
{
"description" : "baker",
"parent_uuid" : "1c4217f2cc6c8afa6532f13475e17ed2",
"uuid" : "bfd0ab9037525887e167e1ed019402b5",
"title" : "cupcake ninja"
}
]
- Purpose: Use the O*NET skills code to obtain the job title.
- Input: O*NET job code
- Output: Full (array) of canonical jobs that map to the given O*NET SOC code including titles (strings) and job uuids (hash)
- Methods: GET
- Note: This is used predominantly by developers who know O*NET
| Status | Description |
|---|---|
| 200 | Successfully found a job that matches the O*NET SOC code. |
| 404 | Unable to find any jobs that matches the O*NET SOC code. |
curl -X GET /path/to/api/v1/jobs/41-3031.00
{
"uuid" : "1092fac0231224962ce7ec82e3bf9b4b",
"onet_soc_code" : "41-3031.00",
"title" : "securities, commodities, and financial services sales agents",
"description" : "buy and sell securities or commodities in investment and trading firms, or provide financial services to businesses and individuals. may advise customers about stocks, bonds, mutual funds, commodities, and market conditions.",
"related_job_titles" : [
{
"uuid" : "cc86db46cb3993b7191bb728feb0ccc5",
"title" : "commodities broker"
},
{
"uuid" : "66005cd41c5c0eda4ab54952d4c13cb2",
"title" : "commodity trader"
},
{
"uuid" : "d0d0da0e68765877f6a8e70987f99085",
"title" : "equity trader"
},
{
"uuid" : "acaff2f509ae940d90ec285c3b96849a",
"title" : "municipal bond trader"
},
{
"uuid" : "8e2b0009a38dc7584780ecea6047a602",
"title" : "mutual fund sales agent"
},
{
"uuid" : "6d2013fc7242946bf91461566d4a30b6",
"title" : "securities trader"
},
{
"uuid" : "ffb56297b6d685596e30286b051b9a4f",
"title" : "stock broker"
}
],
"unusual_job_titles" : [ ]
}
- Purpose: Allows dynamic autocompletion of a skill string as a user is typing.
- Input: (string) Partial (3 characters+) or complete skill name
- Output: Full (array) of canonical skills that contain the given fragment including names (strings) and skill uuids (hash)
- Methods: GET
- Note: This helps ensure consistency in skills that are entered to help with getting associated skills and jobs for a particular skill that is entered.
| Status | Description |
|---|---|
| 200 | Successfully found a collection of skill names matching the given string. |
| 400 | Bad request (i.e. forgotten to specify a parameter or incorrect parameter provided.) |
| 404 | Unable to find any skill names that match the given string. |
curl -X GET /path/to/api/v1/skills/autocomplete?begins_with="java"
[
{
"uuid" : "de9b9ed78d7e2e1dceeffee780e2f919",
"suggestion" : "javascript"
},
{
"uuid" : "ff30ae35a80a94c4e77c02413baa421c",
"suggestion" : "javamin composer"
}
]
curl -X GET /path/to/api/v1/skills/autocomplete?contains="java"
[
{
"uuid" : "de9b9ed78d7e2e1dceeffee780e2f919",
"suggestion" : "javascript"
},
{
"uuid" : "27f2b03acd8b8784acab5c5b60118070",
"suggestion" : "oracle java"
},
{
"uuid" : "04f99eb1151d9033ab1823eb82b8a8e5",
"suggestion" : "oracle java ee"
},
{
"uuid" : "17c4136a02e01c7b27fa3fc360c406cc",
"suggestion" : "asynchronous javascript and xml ajax"
},
{
"uuid" : "5a1ec6e187e8f2cc37e1615211272c59",
"suggestion" : "enterprise javabeans"
},
{
"uuid" : "65821708d91bd434eb7614bd493a991e",
"suggestion" : "oracle javaserver pages jsp"
},
{
"uuid" : "3969d5d4a03b9f9fae765f425bbc9ff4",
"suggestion" : "sun microsystems java 2 platform enterprise edition j2ee"
},
{
"uuid" : "fd5269a86b7526a709220801f14d57f6",
"suggestion" : "oracle java 2 platform enterprise edition j2ee"
},
{
"uuid" : "bd44a6cb68147625f1a7e1dcf73a0640",
"suggestion" : "xerces2 java parser"
},
{
"uuid" : "4de3023163eecffb2a7194a08c185b33",
"suggestion" : "yourkit java profiler"
},
{
"uuid" : "ecffd5adbb9465312d6290006996d414",
"suggestion" : "sun microsystems java servlet api"
},
{
"uuid" : "30da491ae8edb2920db909cfd6be7681",
"suggestion" : "sun microsystems java"
},
{
"uuid" : "ff30ae35a80a94c4e77c02413baa421c",
"suggestion" : "javamin composer"
},
{
"uuid" : "8ccee48c50987ff63fb45478509ed127",
"suggestion" : "oralce java enterprise system"
}
]
curl -X GET /path/to/api/v1/skills/autocomplete?ends_with="java"
[
{
"uuid" : "27f2b03acd8b8784acab5c5b60118070",
"suggestion" : "oracle java"
},
{
"uuid" : "30da491ae8edb2920db909cfd6be7681",
"suggestion" : "sun microsystems java"
}
]
- Purpose: To find the canonical skill name (like “Ruby programming”) for an entered synonymous skill name (like “Coding in Ruby”)
- Input: (string) Arbitrary synonymous skill name
- Params: (number) skill_uuid
- Output: Canonical skill name (string) and uuid (int?)
- Methods: GET, POST (not currently implemented)
- Development Note: The goal is to store what people put in, so the development team can better normalize in the future.
| Status | Description |
|---|---|
| 200 | Successfully found a collection of skill names matching the given title string. |
| 400 | Bad request (i.e. forgotten to specify a parameter or incorrect parameter provided.) |
| 404 | Unable to find any skill names that match the given string. |
curl -X GET /path/to/api/v1/skills/normalize?skill_name="java"
[
{
"skill_name" : "javascript",
"uuid" : "de9b9ed78d7e2e1dceeffee780e2f919"
},
{
"skill_name" : "oracle java",
"uuid" : "27f2b03acd8b8784acab5c5b60118070"
},
{
"skill_name" : "oracle java ee",
"uuid" : "04f99eb1151d9033ab1823eb82b8a8e5"
},
{
"skill_name" : "asynchronous javascript and xml ajax",
"uuid" : "17c4136a02e01c7b27fa3fc360c406cc"
},
{
"skill_name" : "enterprise javabeans",
"uuid" : "5a1ec6e187e8f2cc37e1615211272c59"
},
{
"skill_name" : "oracle javaserver pages jsp",
"uuid" : "65821708d91bd434eb7614bd493a991e"
},
{
"skill_name" : "sun microsystems java 2 platform enterprise edition j2ee",
"uuid" : "3969d5d4a03b9f9fae765f425bbc9ff4"
},
{
"skill_name" : "oracle java 2 platform enterprise edition j2ee",
"uuid" : "fd5269a86b7526a709220801f14d57f6"
},
{
"skill_name" : "xerces2 java parser",
"uuid" : "bd44a6cb68147625f1a7e1dcf73a0640"
},
{
"skill_name" : "yourkit java profiler",
"uuid" : "4de3023163eecffb2a7194a08c185b33"
},
{
"skill_name" : "sun microsystems java servlet api",
"uuid" : "ecffd5adbb9465312d6290006996d414"
},
{
"skill_name" : "sun microsystems java",
"uuid" : "30da491ae8edb2920db909cfd6be7681"
},
{
"skill_name" : "javamin composer",
"uuid" : "ff30ae35a80a94c4e77c02413baa421c"
},
{
"skill_name" : "oralce java enterprise system",
"uuid" : "8ccee48c50987ff63fb45478509ed127"
}
]
- Purpose: Get the associated normalized canonical skill for an O*NET skill code.
- Input: O*NET skill code
- Output: Full (array) of canonical skills that map to the given O*NET skill code including names (strings) and skill uuids (hash)
- Methods: GET
- Note: This is used predominantly by developers who know O*NET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of job titles matching the given string. |
| 400 | Bad request (i.e. forgotten to specify a parameter or incorrect parameter provided.) |
| 404 | Unable to find any job titles that match the given string. |
curl -X GET /path/to/api/v1/skills/13-2011.01
{
"skills" : [
{
"skill_uuid" : "2c77c703bd66e104c78b1392c3203362"
},
{
"skill_uuid" : "a636cb69257dcec699bce4f023a05126"
},
{
"skill_uuid" : "1cea5345d284f36245a94301b114b27c"
},
{
"skill_uuid" : "d1715efc5a67ac1c988152b8136e3dfa"
},
{
"skill_uuid" : "6ae28a55456b101be8261e5dee44cd3e"
}
]
- Purpose: Get skills that are associated with a particular job.
- Input: uuid (int) of canonical job
- Output: Full (array) of canonical skills related to the given job including names (strings) and skill uuids (hash)
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of skills matching the given job uuid. |
| 404 | Unable to find any skills matching the given job uuid. |
curl -X GET /path/to/api/v1/jobs/2995ce54b9dd5944b0528b734cfc5b6d/related_skills
{
"skills" : [
{
"skill_uuid" : "2c77c703bd66e104c78b1392c3203362"
},
{
"skill_uuid" : "a636cb69257dcec699bce4f023a05126"
},
{
"skill_uuid" : "1cea5345d284f36245a94301b114b27c"
},
{
"skill_uuid" : "d1715efc5a67ac1c988152b8136e3dfa"
},
{
"skill_uuid" : "6ae28a55456b101be8261e5dee44cd3e"
}
]
- Purpose: Get other jobs that are closely associated with a particular job.
- Input: uuid (int) of canonical job
- Output: Full (array) of canonical jobs related to the given job including titles (strings) and job uuids (hash)
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of related job titles matching the given uuid. |
| 404 | Unable to find any related job titles that match the given uuid. |
curl -X GET /path/to/api/v1/jobs/2995ce54b9dd5944b0528b734cfc5b6d/related_jobs
{
"related_job_titles" : [
{
"uuid" : "3ecc1eeb50d52a7c01d1ba4cb209bf64",
"title" : "accountant manager"
},
{
"uuid" : "a8f9a074c46b4a5fa97d682953ece9ff",
"title" : "accounting analyst"
},
{
"uuid" : "821833223a9c879cbd63e07ef939a777",
"title" : "accounting bookkeeper"
},
{
"uuid" : "713d5008a3e2288cacbe39f8d424a0dd",
"title" : "accounting consultant"
},
{
"uuid" : "ac309308d805301df489d2237fd9d330",
"title" : "accounting manager"
},
{
"uuid" : "f9cba037e47b1f867a7066a897436817",
"title" : "accounting methods analyst"
}
]
- Purpose: Given a skills, what jobs ask for that skills
- Input: uuid (int) of canonical skill
- Output: Full (array) of canonical jobs related to the given skill including title (strings) and job uuids (hash)
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of job uuids related to the given skill uuid. |
| 404 | Unable to find any job uuids that relate to the given skill uuid. |
curl -X GET /path/to/api/v1/skills/2c77c703bd66e104c78b1392c3203362/related_jobs
{
"skill_uuid" : "2c77c703bd66e104c78b1392c3203362",
"jobs" : [
{
"job_uuid" : "0e9d360ea7be561208352600e287333b"
},
{
"job_uuid" : "ad670393ef16bab4b8dfa52500fb07fe"
},
{
"job_uuid" : "5926b4acee130110cfb1230f41a91bb5"
},
{
"job_uuid" : "f6588d3c2b5961f4123ad01d40bfe1df"
},
{
"job_uuid" : "66daa7c1877e2bf4f31f8f891059db80"
},
{
"job_uuid" : "193e2cfef58673322b3e112004e22464"
},
{
"job_uuid" : "e51fbe56494cd3fb2ff7326b3c0351f3"
},
{
"job_uuid" : "f98f06abc078c9d9c5b6e37d0abeb2f0"
}
]
- Purpose: Skills for a skill. Given a skill, what other skills are relevant / in the same context
- Input: uuid (int) of canonical skill
- Params: (int) number
- Output: Full (array) of canonical skills related to the given skill including names (strings) and skill uuids (hash)
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of skills related to a given skill uuid. |
| 404 | Unable to find any skills related to the given skill uuid. |
curl -X GET /path/to/api/v1/skills/4d70921065c00a293597936b693345aa/related_skills
{
"skills" : [
{
"skill_uuid" : "4d70921065c00a293597936b693345aa",
"skill_name" : "transportation"
},
{
"skill_uuid" : "72c1ac829488e78524689b26180fe9dd",
"skill_name" : "bentley transportation data manager"
},
{
"skill_uuid" : "1df452e6e139d9a119327b0b86d7aa37",
"skill_name" : "cadre technologies cadence transportation management system"
},
{
"skill_uuid" : "6026ff992f2fc47bd13033533fe0ef46",
"skill_name" : "ibm i2 transportation manager"
},
{
"skill_uuid" : "32b281d69aad9ac2e891656faa9c80f5",
"skill_name" : "intergraph geomedia transportation manager"
},
{
"skill_uuid" : "764a79c8d6122de1b74f4dbecc4f8b08",
"skill_name" : "transportation management system tms software"
},
{
"skill_uuid" : "4175dbdfc632eead9358add5f23d45fe",
"skill_name" : "animal transportation trailers"
},
{
"skill_uuid" : "284a64785fec51035575e1aed35223d9",
"skill_name" : "i2 transportation modeler"
},
{
"skill_uuid" : "97a70aa1658367be03b7b5e52c7f268e",
"skill_name" : "autodesk caice visual transportation software"
}
]
- Purpose: Given a skill uuid, what is the name of that associated skill
- Input: (int) skill_uuid
- Params: (int) number
- Output: Returns a skill string with the name of a skill
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a skill matching the given uuid. |
| 404 | Unable to find any skills that match the given uuid. |
curl -X GET /path/to/api/v1/skills/4d70921065c00a293597936b693345aa
{
"uuid" : "4d70921065c00a293597936b693345aa",
"skill_name" : "transportation",
"count" : 825494
}
- Purpose: Retrieves the name of a job given its uuid.
- Input: Job uuid
- Output: Name of the job that matches the specified uuid.
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of job titles matching the given job uuid |
| 404 | Unable to find any job titles that match the given job uuid. |
curl -X GET /path/to/api/v1/jobs/5d12ef84fe6bc1ead14db1b113188625
{
"uuid" : "5d12ef84fe6bc1ead14db1b113188625",
"onet_soc_code" : "35-3011.00",
"title" : "bartenders",
"description" : "mix and serve drinks to patrons, directly or through waitstaff.",
"related_job_titles" : [
{
"uuid" : "b912fc356c374dfb499fdd52549f522c",
"title" : "bar attendant"
},
{
"uuid" : "7541d29b266e99847654557ea55746d6",
"title" : "bar captain"
},
{
"uuid" : "aec7e8975fb951f73bcdc001dec5a6dd",
"title" : "bar tender"
},
{
"uuid" : "49d9a1aa749fd06c287640e7015b5b8e",
"title" : "barkeep"
},
{
"uuid" : "f9d2636a23dd562841e6a96ad10b3a1a",
"title" : "barkeeper"
},
{
"uuid" : "411272f57d8bab247646011f9361bc5e",
"title" : "barmaid"
},
{
"uuid" : "1e7f0bbc56c5ba6791108be53a75f494",
"title" : "barman"
},
{
"uuid" : "7bb0b63fe7ca769b3e05fc6200931b82",
"title" : "bartender"
},
{
"uuid" : "aa920056eedd0e75a4d730a9d3c7ba94",
"title" : "bartender extra"
},
{
"uuid" : "e0c4b599e30cf975677ec9b059a534f4",
"title" : "bartender server"
},
{
"uuid" : "f47de1b27e11d1e48e6751a474bc498e",
"title" : "drink mixer"
},
{
"uuid" : "2cf4119132f053fee587bfbe4b049bac",
"title" : "mixologist"
},
{
"uuid" : "cf1e8c14e54505f60aa10ceb8d5d8ab3",
"title" : "server"
},
{
"uuid" : "4b4cc86661a8ad75946504946b32d683",
"title" : "taproom attendant"
},
{
"uuid" : "9bc7a5c444110e35041eb91528d60a73",
"title" : "waitress"
}
],
"unusual_job_titles" : [
{
"uuid" : "0482ab77804c699be0566a6cfaff7c09",
"title" : "beverage dissemination officer"
}
]
}
- Purpose: Retrieves the names and uuids of all jobs.
- Input: None
- Output: Full (array) of canonical jobs containing the given fragment including titles (strings) and job uuids.
- Methods: GET
| Status | Description |
|---|---|
| 200 | Successfully found a collection of job titles. |
| 404 | Unable to find any job titles. |
curl -X GET /path/to/api/v1/jobs
[
{
"uuid" : "2995ce54b9dd5944b0528b734cfc5b6d",
"onet_soc_code" : "13-2011.01",
"title" : "accountants",
"description" : "analyze financial information and prepare financial reports to determine or maintain record of assets, liabilities, profit and loss, tax liability, or other financial activities within an organization."
},
{
"uuid" : "c29b97d49d0bf40abb6c79fc8a670ff9",
"onet_soc_code" : "13-2011.00",
"title" : "accountants and auditors",
"description" : "examine, analyze, and interpret accounting records to prepare financial statements, give advice, or audit and evaluate statements prepared by others. install or advise on systems of recording costs or other financial and budgetary data."
},
{
"uuid" : "67ef4f4b074578fd523ee3442c1c4fa0",
"onet_soc_code" : "27-2011.00",
"title" : "actors",
"description" : "play parts in stage, television, radio, video, motion picture productions, or other settings for entertainment, information, or instruction. interpret serious or comic role by speech, gesture, and body movement to entertain or inform audience. may dance and sing."
},
{
"uuid" : "73ac4285eab539863c77b5d09d7428cd",
"onet_soc_code" : "15-2011.00",
"title" : "actuaries",
"description" : "analyze statistical data, such as mortality, accident, sickness, disability, and retirement rates and construct probability tables to forecast risk and liability for payment of future benefits. may ascertain insurance rates required and cash reserves necessary to ensure payment of future benefits."
}
]
- Purpose: Retrieves the names and uuids of all skills.
- Input: None
- Output: Full (array) of canonical skills containing the given fragment including names (strings) and skill uuids.
- Methods: GET
- Notes: The skill collection is huge! It may take a while before the API call returns a full dataset. Need to add pagination in future sprints.
| Status | Description |
|---|---|
| 200 | Successfully found a collection of skill names. |
| 404 | Unable to find any skill names. |
curl -X GET /path/to/api/v1/skills
[
{
"uuid" : "4d70921065c00a293597936b693345aa",
"name" : "transportation",
"count" : 825494
},
{
"uuid" : "162cb662c7ef4dc9e86a2b5e88cbcdf9",
"name" : "clerical",
"count" : 373370
},
{
"uuid" : "31c13f47ad87dd7baa2d558a91e0fbb9",
"name" : "design",
"count" : 367424
},
{
"uuid" : "7a139a9ea37cb26f0636f24db60d9b77",
"name" : "telecommunications",
"count" : 354887
},
{
"uuid" : "9df22f196a33acd0b372fe502de51211",
"name" : "auto",
"count" : 293496
},
{
"uuid" : "7e3fdeae0d52916ea5c86c7e5291f5be",
"name" : "mechanical",
"count" : 230560
},
{
"uuid" : "8f4d7acea7806e0ab206358f93ccd3e1",
"name" : "microsoft office",
"count" : 225979
},
{
"uuid" : "fb5c7f9bb4b32ce2f3bff4662f1ab27b",
"name" : "science",
"count" : 204025
}
]