This documentation specifies the technical requirements of the Jobposting Search API for Job Market Finland and describes
how to use the actual API. The onboarding process for the API is explained in more detail on
Job Market Finland website. The OpenAPI descriptions
for the P67 interface related to jobposting management can also be found there.
Jobpostings can be retrieved from the Job Market Portal via this interface to the external services. It is possible to apply various filters to narrow down the search results. The search results are returned in accordance with the structure of the jobposting.
The interface for searching jobpostings at the Job Market Finland is provided via the KEHA Center's integration platform (Kipa). The credentials for using the integration platform and the IP addresses openings are provided by the KEHA Center as part of the interface implementation process. The credentials required for using the interface are delivered to the interface user securely. More detailed information about the implementation can be found on the Job Market Finland website.
Detailed processes for searching jobpostings is illustrated in the diagram below.
Actual searching of jobpostings is done through the P67 service of the Kipa integration platform, which connects to
Job Market Finland's backend service. Available functions, data structure, and responses are described in the
management API YAML description.
The request is made using the HTTP POST method so that the updated filters can be more easily included in the request and their processing is more straightforward at both ends of the interface.
Calls through the Kipa integration platform are authorized using an API key mechanism, and the header information of the request must include the KIPA-Subscription-Key provided for Kipa usage.
The P67 service of the Kipa integration platform can be found at the following addresses:
https://api-qa.ahtp.fi/kipa/p67/v2/jobpostingshttps://api.ahtp.fi/kipa/p67/v2/jobpostingsFiltered search results are returned to the external service as Newline-delimited JSON (NDjson) stream.
Different codeset values related to the jobpostings are available from the Job Market Finland's codeset service. The codesets of different type of data are described below. The OpenApi description also contains information about the attributes related to the code values.
The json structure of the codeset is read in such a way that the code values can be found in the tunnus element and
the description related to the id localized in the selite element. Each code value also has a validity period. The
codeset may therefore contain code values that have already been removed from use. In such cases, the codes have
loppupaiva information. Some codesets may have extensions that can be used to refine the use of the codeset. For example,
the osajoukko extension is used to limit only certain codes to a specific purpose. The Järjestysnumero extension
indicates the desired order of the codes, for example in selection lists.