Normalization

SkyHive’s Normalize API helps you convert your existing skills and job titles to align with SkyHive’s ontology and enable matching around a common nomenclature. With this API, you can:

  • Migrate legacy skills and job titles to support a smooth transition into SkyHive

Normalization API Methods

You can align existing skills and job titles using the following methods:

Use Cases

The following use case covers a possible application of the Normalize API:

Normalize Weights

Calculate the weights for an array of skills using a configuration object.

Securityauth
Request
header Parameters
X-Enterprise-Id
required
string
Request Body schema: application/json
required
Array of objects (Skill-6) unique
object (WeightConfig)
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

post/normalize/weight
Request samples
application/json
{
  • "skills": [
    ],
  • "weightConfig": {
    }
}
Response samples
application/json
{
  • "skills": [
    ]
}

Normalize Skill

Normalize the specified skill to a cluster skill in SkyHive's dictionary.

Securityauth
Request
path Parameters
title
required
string

Skill title

query Parameters
resultsPerPage
integer <int32>
Default: 5

Page size for paging

header Parameters
X-Enterprise-Id
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

get/normalize/skills/{title}
Request samples
Response samples
application/json
{
  • "query": "string",
  • "values": [
    ]
}

Normalize Job Title

Normalize the specified job title to a cluster title in SkyHive's dictionary.

Securityauth
Request
path Parameters
title
required
string

Job title

header Parameters
X-Enterprise-Id
required
string
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

get/normalize/jobtitle/{title}
Request samples
Response samples
application/json
{
  • "query": "string",
  • "values": [
    ]
}