« Back to operation list

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.

Try it!

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:

Fields related to Skill SkillCategory
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": []
         }
      ]
   }
]
Try it!

Sections: