Skill Ontology API and Plugin – Documentation

Base URL: https://skills.itsyourskills.com/api


'It's Your Skills' maintains and constantly enriches a unique Skills Ontology. A Skills Ontology is more than just a database. It provides categorization, clustering, synonyms, and more to make skills mapping holistic and insightful. The Skills Ontology is comprehensive, covering every industry and function. The Skills Ontology can be used for developing HR applications. The resources from the Skills Ontology can be accessed through our API using the following API calls and an API key generated uniquely for each subscriber.

What's Next?

The resources from the Skills Ontology can be accessed through our API using the following API calls and an API key generated uniquely for each subscriber.

Add Resources

You can either reference the plugins directly from our site which is recommended since you will be assured that you have the latest plugin or you can download the plugins below.

Skills Plugin CDN

Skills with Roles Plugin

<script type="text/javascript" src="https://skills.itsyourskills.com/plugins/js/skills.roles.min.js"></script>

Complete Skills Profiler Plugin

<script type="text/javascript" src="https://skills.itsyourskills.com/plugins/js/skills.profiler.min.js"></script>

Skills Search Plugin

<script type="text/javascript" src="https://skills.itsyourskills.com/plugins/js/skills.search.min.js"></script>

Css

<script type="text/javascript" src="https://skills.itsyourskills.com/plugins/css/skills.profiler.min.css"></script>

Skills Plugin Download

Integrate in your site

Plugin Integration Steps

Add the respective script

Before adding the Its Your Skills plugin, please make sure you have the jquery plugin on your site.

Add the relevent js file for the plugin you purchased. Assuming you have downloaded the plugin already, place your plugin in the head tag of your html page like below (replace the src attribute with the name of the plugin and location in your local environment)

<script type="text/javascript" src="js/skills.roles.min.js"></script>

Add the css file for the plugin. Assuming you have downloaded the css already from the download section, place your css in the head tag of your html page like below (replace the src attribute with the name of the css and location in your local environment)

<link href="css/skills.profiler.min.css" rel="stylesheet">

Initialise the plugin

Once you have all the relevent files, you have to initialise the plugin to get started.


First add an empty div tag to wherever you want the Its your Skills plugin to be with a unique id as below

<div id="iys-skills-plugin"></div>

Now reference that div you created using its id and initialise the Its Your Skills plugin on the empty div in your script


              var handler=$('#iys-skills-plugin').SE({
                    client_id: 'Your Client id goes here',
                    client_secret: 'Your Client Secret goes here',
                    allowRating: 0 //disables rating in the plugin. If not mentioned, the rating will be available by default. (Not available in skills search plugin)
                    allowComments: 0 //disables comments in the plugin. If not mentioned, the comments will be available by default. (Not available in skills search plugin)
                    allowPreview: 0 //disables preview section in the plugin. If not mentioned, the preview will be available by default. (Not available in skills search plugin)
                });
            

Now this should show the respective plugin in the div tag you declared on your site


Get json output

Once you have choosen the skills and rating and comments, you can export them into a json file

Add an output button for the plugin like below

<button id="skills-output">Output</button>

Now call the output function on click of the output button like below (Add the following code in the same function as plugin initialisation)


                $('#output').click(function(){
                  console.log(JSON.stringify(handler.getSave()));
                  var outputJson = JSON.stringify(handler.getSave());
                });
              

Now outputJson contains your json object with all the skills selected. You can store it in your database to view or edit later.


View/Edit Json

To view the stored json file in the Its Your Skills Plugin again, retrieve the saved json from the database and pass it as a parameter to the plugin initialisation code like below


                  var handler=$('#iys-skills-plugin').SE({
                    client_id: 'Your Client id goes here',
                    client_secret: 'Your Client Secret goes here',
                    data: outputJson
                  });
                

Now you can add/delete/edit skills

Click here for an interactive tutorial of how to use IYS API

API Integration Steps

Add the respective script

Before adding the Its Your Skills plugin, please make sure you have the jquery plugin on your site.

Add the relevent js file for the plugin you puchased. Assuming you have downloaded the plugin already, place your plugin in the head tag of your html page like below (replace the src attribute with the name of the plugin and location in your local environment)

<script type="text/javascript" src="js/skills.search.min.js"></script>

Add the css file for the plugin. Assuming you have downloaded the css already from the download section, place your css in the head tag of your html page like below (replace the src attribute with the name of the css and location in your local environment)

<link href="css/skills.profiler.min.css" rel="stylesheet">

Access Token

Before you begin to start using Its Your Skills Api, you need to authenticate yourself by acquiring an access token for your Client Id and Client Secret.

In-order to get an access token, you have to make the following http request in any of your prefered http client (Postman, Curl, ajax..)

Please make sure the parameters are added as form parameters and not as json data or any other.

Following is an example done in php.


                    $response = $guzzle->post('https://skills.itsyourskills.com/oauth/token', [
                      'form_params' => [
                        'grant_type' => 'client_credentials',
                        'client_id' => 'client-id', //insert your client id here
                        'client_secret' => 'client-secret', //insert your client secret here
                      ],
                    ]);
                  

If everything goes right, you should have a response similar to this

                    
                      {
                        "token_type": "Bearer",
                        "expires_in": 31536000,
                        "access_token": "Your access token received from our servers" //keep this for future API calls
                      }
                    
                  

All you need is the value of access_token from the above code

You can generate a new access_token everytime by the above method and your old access token will be invalid


API Calls

Skill Search

You can search for any skill you want from an extensive database of more than 70000 skill. This call is used to search for a particular skill and similar skills.

In-order to do any API calls to Its Your Skills API, you pass in the access_token in the Authorization header of each API calls like below


                  Authorization: Bearer 'Your access token goes here'
                

Then you post your search query as a parameter to the API route below


                  https://skills.itsyourskills.com/api/skill-search?q=java
                

Here java is your search query and it returns the json below

                  
                    {
                      "skills": [
                      {
                        "id": "bx0VrlRm7pndaOwv",
                        "skill_name": "Java",
                        "r": 6.697272777557373
                      },
                      {
                        "id": "yPxgV6GA5LMdR8NJ",
                        "skill_name": "Java Servlets",
                        "r": 6.62198543548584
                      },
                      {
                        "id": "aqVz56nzVjZ6BKGo",
                        "skill_name": "Java Card OpenPlatform",
                        "r": 6.548372268676758
                      },
                      {
                        "id": "PgDxRdjX43X6KXNW",
                        "skill_name": "Java Scripting in Networking",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "pyxG3dgnANjEg4eK",
                        "skill_name": "Business Components for Java",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "wZqzBdLR7Lr601bY",
                        "skill_name": "EJB (Enterprise Java Beans)",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "Xp4g5E1ZAjrdbKN3",
                        "skill_name": "Java Abstract Window Toolkit",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "JANob62jAyx6kaZy",
                        "skill_name": "Java Platform Micro Edition",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "NRwrmdYw7my6ezL3",
                        "skill_name": "JDBC (Java Database Connectivity)",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "kxzqO64ZAyZd4BmJ",
                        "skill_name": "JDK (Java Development Kit)",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "7yGaREZe7XJ6Q8NW",
                        "skill_name": "JMS (Java Message Service)",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "Pq35KdkrAk0ERAOZ",
                        "skill_name": "JVM (Java Virtual Machine)",
                        "r": 6.476377487182617
                      },
                      {
                        "id": "9rWYel0MAyj6JROq",
                        "skill_name": "Java Architecture for XML Binding",
                        "r": 6.405949115753174
                      },
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      {
                        "id": "O2QyVl8Z5VrEGX4N",
                        "skill_name": "JavaOS",
                        "r": 0
                      }]
                    }
                  
                

The above json response gives you all the skills that has the word 'java' in it. r is the ranking of the skill based on the similarity with your search query.


Related Skill Search

Once you picked your skill from the above search, you can use its id to fetch more skills related to that skill

In-order to do any API calls to Its Your Skills API, you pass in the access_token in the Authorization header of each API calls like below


                  Authorization: Bearer 'Your access token goes here'
                

To get all the related skills, you pass the id of the skill from previous response as below


                  https://skills.itsyourskills.com/api/related-skill-search?id=bx0VrlRm7pndaOwv
                

Here bx0VrlRm7pndaOwv is the id of java and it returns the json below

                  
                    {
                      "skill_name": "Java",
                      "skill_category": "Programming Languages",
                      "related_skills": [
                      {
                        "id": "NRwrmdYw7vG6ezL3",
                        "skill_name": "ActionScript"
                      },
                      {
                        "id": "VewG3d5VAQelJ7km",
                        "skill_name": "F#"
                      },
                      {
                        "id": "wZqzBdLR7WV601bY",
                        "skill_name": "Factor"
                      },
                      {
                        "id": "pyxG3dgnA5LEg4eK",
                        "skill_name": "Falcon"
                      },
                      {
                        "id": "ko84zlVeJ1BdDybQ",
                        "skill_name": "FastCGI"
                      },
                      {
                        "id": "z7jAgdvoz5VlVwrO",
                        "skill_name": "Fantom"
                      },
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      .
                      {
                        "id": "NzoyjlaX5vndn1rg",
                        "skill_name": "Prolog"
                      },
                      {
                        "id": "a4yZKlbV7R9lDQ59",
                        "skill_name": "Pro*C/C++"
                      },
                      {
                        "id": "7yGaREZe7v96Q8NW",
                        "skill_name": "Xtend"
                      },
                      {
                        "id": "bx0VrlRm7pndaOwv",
                        "skill_name": "Java"
                      }
                      ],
                      "related_categories": [
                      {
                        "id": "q3znolpexzq6xGBY",
                        "skill_name": "Business Domain"
                      },
                      {
                        "id": "rG0O2Eze1LV6yQYL",
                        "skill_name": "Concepts, Software Development"
                      },
                      {
                        "id": "pyxG3dgnNA8Eg4eK",
                        "skill_name": "Operational Role"
                      },
                      {
                        "id": "NzoyjlaXGV8dn1rg",
                        "skill_name": "Programming Languages"
                      },
                      {
                        "id": "rL41Q6xW2OWlJbAn",
                        "skill_name": "Software Domain"
                      },
                      {
                        "id": "oLeR0EQ4Gmw6qpgX",
                        "skill_name": "Tools and Technologies"
                      }]
                    }
                  
                

In the above json response, skill_name is the name of the skill you searched for.

skill_category is the category to which the skill belongs

related_skills gives all the skills that belong in this category

related_categories has all the categories related to the category of the searched skill.


Related Category Search

Apart from searching based on the skill, you can also choose a category and fetch all the skills under that category.

In-order to do any API calls to Its Your Skills API, you pass in the access_token in the Authorization header of each API calls like below


                Authorization: Bearer 'Your access token goes here'
              

To do that, pass the id of any related_category from the above json response like this


                https://skills.itsyourskills.com/api/category-search?id=q3znolpexzq6xGBY
              

Here q3znolpexzq6xGBY is the id of Business Domain category and it returns the json below

                
                  {
                    "category_name": "Business Domain",
                    "skills": [
                    {
                      "id": "19KMQENJ2eYELDjP",
                      "skill_name": "Utilities"
                    },
                    {
                      "id": "8rxyB6qjPbgE9pLk",
                      "skill_name": "Life Sciences"
                    },
                    {
                      "id": "ko84zlVerakdDybQ",
                      "skill_name": "Information Research, Processing"
                    },
                    {
                      "id": "z7jAgdvoKpxlVwrO",
                      "skill_name": "HR"
                    },
                    {
                      "id": "pyxG3dgnyO8Eg4eK",
                      "skill_name": "Healthcare"
                    },
                    {
                      "id": "wZqzBdLRbGD601bY",
                      "skill_name": "Government Services"
                    },
                    .
                    .
                    .
                    .
                    .
                    .
                    .
                    {
                      "id": "ynkeVd7Qp2Z6Y305",
                      "skill_name": "Other Financial Services"
                    },
                    {
                      "id": "oeA2V63XpeMEJnMG",
                      "skill_name": "Marketing"
                    },
                    {
                      "id": "yPxgV6GArkZdR8NJ",
                      "skill_name": "Banking, Investment Banking"
                    }
                    ],
                    "related_categories": [
                    {
                      "id": "q3znolpexzq6xGBY",
                      "skill_name": "Business Domain"
                    },
                    {
                      "id": "rG0O2Eze1LV6yQYL",
                      "skill_name": "Concepts, Software Development"
                    },
                    {
                      "id": "pyxG3dgnNA8Eg4eK",
                      "skill_name": "Operational Role"
                    },
                    {
                      "id": "NzoyjlaXGV8dn1rg",
                      "skill_name": "Programming Languages"
                    },
                    {
                      "id": "rL41Q6xW2OWlJbAn",
                      "skill_name": "Software Domain"
                    },
                    {
                      "id": "oLeR0EQ4Gmw6qpgX",
                      "skill_name": "Tools and Technologies"
                    }]
                  }
                
              

In the above json response, category_name is the name of the category you searched for.

skills are all the skills under that category.

related_categories has all the categories related to the category searched.

It's Your Skills

It’s Your Skills combines rich experience in the Human Resources (HR) and capabilities in the cutting edge web technologies to create novel solutions in the global talent space.