« Back to operation list

get/curriculum/{curriculumId}/skill

Allows to read the skills of a Curriculum that belongs to the authenticated user. It returns two types of skill, expertise and language, each one with different attributes.

Please notice that the expertise subtype entity contains only the skill name and level of knowledge.

The language subtype entity contains the skill instead of descriptive names. If you need to use these descriptive names you may use the /candidate/skill API operation with categoryId=1301. You should think about caching the data returned because this information does not change often and you will save some client-server roundtrips.

Try it!

Request

Resource URL

https://api.infojobs.net/api/2/curriculum/{curriculumId}/skill

Security

  • User Role: rol_candidate
  • Scope: candidate_read_curriculum_skills

Parameters

Name Description

curriculumId

String

Required

Alpha-numeric code identifying the currilumn. This curriculum must belongs to the authenticated user.

Example values: 70628530-6d45-483a-8327-d8c81b

Response

Response fields

Fields related to the curriculumSkills entity
Name Description

expertise

Array(Expertise)

Returns a list of expertise skills.

language

Array(Language)

Returns a list of language skills.

Fields related to the expertise skill entity
Name Description

skill

String

The skill descriptive name.

level

String

The key identifier of the expertise level for this skill. Below you can see the possible values for this field.

Maximum length: 25
Fields related to the language skill entity
Name Description

id

Long

The skill identifier. The operation /candidate/skill?categoryId={categoryId} returns the availables skills for a given category.

category

Long

The identifier of the skill category. The operation /candidate/skillCategory returns all available categories.

reading

String

The key indentifier of the reading level for this skill. Below you can see the possible values for this field.

Maximum length: 25

speaking

String

The key identifier of the speaking level for this skill. Below you can see the possible values for this field.

Maximum length: 25

writing

String

The key identifier of the writing level for this skill. Below you can see the possible values for this field.

Maximum length: 25

comments

String

Candidate comments about this skill.

Maximum length: 200
Available expertise level values:
key Public name

bajo

Bajo

medio

Medio

alto

Alto

Available speaking values:
key Public name

nulo

Nulo

elemental

Elemental

conversacion

Conversación

negociacion

Negociación

nativo

Nativo

Available reading/writing values:
key Public name

nulo

Nulo

basico

Básico

medio

Medio

alto

Alto

excelente

Excelente

Error codes

Code Description

361

The curriculum was not found or the authenticated user is not the owner.

Examples

This example gets the skills of the authenticated user for the given curriculum.

Request

http://api.infojobsco.net/api/2/curriculum/E5B265D1-FA87-96B3-6A5EC0BE3125817E/skill

Response

{
   "expertise": [
      {
         "skill": "Java",
         "level": "medio",
      }
   ],
   "language": [
      {
         "id": 3,
         "comments": "",
         "category": 1301,
         "writing": "nulo",
         "speaking": "conversacion",
         "reading": "alto"
      }
   ]
}
Try it!

Sections: