get/candidate/skill
This operation returns all the candidate skills available for a given skill category, the returned skills can be used to complete the CV.
Please notice that for this operation to work, it is required to send the URL parameter categoryId with the id of the skill category which we want to return the skills. To see the available skill categories and their ids, the /candidate/skillcategory API operation can be used.
Request
Resource URL
https://api.infojobs.net/api/1/candidate/skill
Security
- User Role: public
- Scope: none
Parameters
| Name | Description |
|---|---|
|
categoryId Long Required |
The Skill Category's identifier of the skills the service will return |
Response
Response fields
The response will contain an Array of Skill entities. See below for details:
| Name | Description |
|---|---|
|
id Long Required |
A numeric unique identifier of the skill in the InfoJobs system |
|
name String Required |
A human readable name for the Skill. Maximum length: 60 |
|
type String Required |
The Maximum length: 10 |
|
order Long Required |
The order is a numeric field can be used to order the skills in a proper way |
|
deprecated boolean Required |
This field is a boolean flag indicating if the skill will be removed from the InfoJobs system soon, so it cannot be used to create new skills for candidates. |
Error codes
| Code | Description |
|---|---|
648 | The categoryId parameter is required to execute this operation. |
649 | No skill category was found for the given category id. |
Examples
This example gets the skills for the category "Análisis y programación" identified with the id 1403
Request
http://api.infojobs.net/api/1/candidate/skill?categoryId=1403
Response
[
{
"id": 172788035,
"name": "Desarrollo cliente-servidor",
"type": "expertise",
"order": 172788035,
"key": "desarrollo-cliente-servidor",
"deprecated": false
},
{
"id": 172788097,
"name": "Arquitectura de Software",
"type": "expertise",
"order": 172788097,
"key": "arquitectura-de-software",
"deprecated": true
}
...
]
