get/candidate/skillcategory
This operation returns all the skill categories available at InfoJobs. These skill categories have a tree format and only the ones not having subcategories have skills associated directly to them. It is possible to get all the available skill categories along with their associated skills by adding the includeSkills parameter with value true to the request.
IMPORTANT: You should think about caching these data once retrieved because the amount of information sent by the network for each request it's important (above 1,5Mb) and it could cause your client application to run slow. These skills don't often change.
Request
Resource URL
https://api.infojobs.net/api/1/candidate/skillcategory
Security
- User Role: public
- Scope: none
Parameters
| Name | Description |
|---|---|
|
includeSkills Boolean Optional |
Using this parameter with value true will cause the returned skill categories will also contain the associated skills to them |
Response
Response fields
The response will contain a list categories with its subcategories. If the includeSkills parameter with value true is sent the child categories will contain also the skills associated to them. See below for details:
| Name | Description |
|---|---|
|
id Long Required |
A numeric unique identifier of the skill category |
|
name String Required |
The descriptive name of the skill category. Maximum length: 100 |
|
order Long Required |
The field order is a numeric field that can be used to order the skill categories. |
|
parentCategoryId Long Required |
It's the numeric identifier for the skill's parent skill category. |
|
subcategories Array(SkillCategory) Optional |
Array containing the Skill Categories children of the current Category |
|
skills Array(Skills) Optional |
Attribute informed when the parameter includeSkills with value true is used in the request. It's an Array containing the Skills associated to the Skill Category. Note that only the categories with no subcategories contain skills |
Examples
This example gets the whole skill category tree witho no skills.
Request
http://api.infojobsco.net/api/1/candidate/skillcategory
Response
[
{
"id": 13,
"name": "Idiomas",
"order": 13,
"type": 0,
"parentCategoryId": 0,
"subcategories": [
{
"id": 1301,
"name": "Dominio de idiomas",
"order": 1301,
"parentCategoryId": 13,
"subcategories": []
},
{
"id": 1302,
"name": "Traducción e interpretación",
"order": 1302,
"parentCategoryId": 13,
"subcategories": []
}
]
}
]
