arbetsformedlingen 0.6.0 → 0.7.0

data/lib/arbetsformedlingen/api/client.rb

@@ -13,6 +13,7 @@ require 'arbetsformedlingen/api/matchning_client'
 require 'arbetsformedlingen/api/ledigtarbete_client'
 
 module Arbetsformedlingen
+  # API namespace
   module API
     # Main API client
     class Client
@@ -37,7 +38,7 @@ module Arbetsformedlingen
 
       # Post ad to API (ad => annons)
       # @return [Values::CreateAdPage] the result.
-      # @param [Arbetsformedlingen::Packet] Packet object.
+      # @param [Arbetsformedlingen::Packet] packet
       # @example Post ad
       #    client.ad(packet)
       def create_ad(packet)

data/lib/arbetsformedlingen/api/ledigtarbete_client.rb

@@ -16,7 +16,7 @@ module Arbetsformedlingen
       }.freeze
 
       # Post ad to API
-      # @param [Arbetsformedlingen::Packet, #to_xml] the data to be sent
+      # @param [Arbetsformedlingen::Packet, #to_xml] packet the data to be sent
       # @return [Values::CreateAdPage] the API result
       def create_ad(packet)
         xml = packet.to_xml

data/lib/arbetsformedlingen/api/ontology_client.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module Arbetsformedlingen
+  module API
+    # API client for ontology
+    # @see http://ontologi.arbetsformedlingen.se/ontology/v1/?url=swagger.json
+    class OntologyClient
+      attr_reader :request
+
+      # Base API URL
+      BASE_URL = 'http://ontologi.arbetsformedlingen.se/ontology/v1'
+
+      # Valid types
+      VALID_TYPES = %w[skill occupation trait].freeze
+
+      # Initialize client
+      def initialize(request: Request.new(base_url: BASE_URL))
+        @request = request
+      end
+
+      # GET /concept - Fetches a list of concepts
+      # @return [Response]
+      def concepts(filter: nil, offset: nil, limit: nil, type: nil)
+        query = to_params(filter: filter, offset: offset, limit: limit, type: type)
+
+        request.get('/concept', query: query)
+      end
+
+      # GET /concept/:uuid} - Fetch a concept given an uuid
+      # @return [Response]
+      def concept(uuid)
+        request.get("/concept/#{uuid}")
+      end
+
+      # GET /concept/related - Fetches related concepts for any number of
+      # concepts and/or uuids
+      # @return [Response]
+      def concepts_relations(uuids: [], names: [], limit: nil, type: nil)
+        concepts = (
+          names.map { |name| ['concept', name] } +
+          uuids.map { |name| ['uui', name] }
+        ).reject(&:empty?)
+
+        query = to_params(limit: limit, type: type).to_a.concat(concepts)
+
+        request.get('/concept/related', query: query)
+      end
+
+      # GET /concept/:uuid/terms - Fetches the terms for the given uuid
+      # @return [Response]
+      def concept_terms(concept_uuid, offset: nil, limit: nil)
+        query = to_params(offset: offset, limit: limit)
+
+        request.get("/concept/#{concept_uuid}/terms", query: query)
+      end
+
+      # GET /concept/:uuid/related/:type - Fetches related concepts for the
+      # given uuid, returning only concepts of the given type
+      # @return [Response]
+      def concept_relations(concept_uuid, type, offset: nil, limit: nil)
+        query = to_params(offset: offset, limit: limit)
+
+        request.get("/concept/#{concept_uuid}/related/#{type}", query: query)
+      end
+
+      # GET /terms - Fetches a list of terms
+      # @return [Response]
+      def terms(filter: nil, offset: nil, limit: nil, type: nil)
+        query = to_params(filter: filter, offset: offset, limit: limit, type: type)
+
+        request.get('/terms', query: query)
+      end
+
+      # GET /:type/:description - Redirects to the concepts UUID
+      # @return [Response]
+      def type_description(type, description)
+        request.get("/#{type}/#{description}")
+      end
+
+      # GET /:type/:description/related/:totype - Redirects to the concepts
+      # UUID related concepts
+      # @return [Response]
+      def type_description_relations(type, description, relation_type)
+        request.get("/#{type}/#{description}/related/#{relation_type}")
+      end
+
+      # POST /text-to-structure - Analyzes a text and returns the concepts found
+      # @return [Response]
+      def text_to_structure(text)
+        request.post('/text-to-structure', data: { text: text })
+      end
+
+      private
+
+      def to_params(filter: nil, offset: nil, limit: nil, type: nil)
+        if type && !VALID_TYPES.include?(type)
+          raise(ArgumentError, "invalid type #{type}, valid types are #{VALID_TYPES.join(', ')}") # rubocop:disable Metrics/LineLength
+        end
+
+        {
+          filter: filter,
+          offset: offset,
+          limit: limit,
+          type: type,
+        }.delete_if { |_k, v| v.nil? }
+      end
+    end
+  end
+end

data/lib/arbetsformedlingen/api/request.rb

@@ -17,22 +17,52 @@ module Arbetsformedlingen
         @locale = locale
       end
 
-      # Perform GEt request
+      # Perform GET request
       # @param [String] url to be fetched
-      # @param [Hash] query params
+      # @param [Hash, Array<Array<#to_s>>] query params
       # @return [Response] response object
       def get(url, query: {})
-        uri = URI("#{base_url}#{url}?#{URI.encode_www_form(query.to_a)}")
+        uri = to_uri(url, query: query)
 
         http = Net::HTTP.new(uri.host, uri.port)
-
         request = Net::HTTP::Get.new(uri)
         request['Content-Type'] = 'application/json'
         request['Accept-Language'] = locale
 
         response = http.request(request)
+        # AFs APIs somtimes redirects with HTTP 303
+        if response.code == '303' && response.header['Location']
+          return get(response.header['Location'], query: query)
+        end
+
+        Response.new(response, uri)
+      end
+
+      # Perform POST request
+      # @param [String] url to be fetched
+      # @param [Hash] data params
+      # @return [Response] response object
+      def post(url, data: {})
+        uri = to_uri(url)
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        request = Net::HTTP::Post.new(uri)
+        request['Content-Type'] = 'application/json'
+        request['Accept-Language'] = locale
+        request['cache-control'] = 'no-cache'
+        request.body = JSON.dump(data)
+
+        response = http.request(request)
+
+        Response.new(response, uri)
+      end
+
+      private
+
+      def to_uri(url, query: {})
+        full_url = URI(url.to_s).absolute ? url : "#{base_url}#{url}"
 
-        Response.new(response)
+        URI("#{full_url}?#{URI.encode_www_form(query.to_a)}")
       end
     end
   end

data/lib/arbetsformedlingen/api/response.rb

@@ -9,10 +9,13 @@ module Arbetsformedlingen
   module API
     # API response object
     class Response
+      attr_reader :uri
+
       # Initialize response
-      def initialize(response)
+      def initialize(response, uri = nil)
         @response = response
         @json = nil
+        @uri = uri
       end
 
       # True if response is 200

data/lib/arbetsformedlingen/api/results/ad_result.rb

@@ -16,6 +16,7 @@ module Arbetsformedlingen
 
       # private
 
+      # :nodoc:
       def self.build_page(response)
         response_data = response.json
         data = response_data.fetch('platsannons')
@@ -42,10 +43,12 @@ module Arbetsformedlingen
         )
       end
 
+      # :nodoc:
       def self.build_empty(response)
         Values::Ad.new(response: response)
       end
 
+      # :nodoc:
       def self.build_terms(data)
         Values::Terms.new(
           duration: data.fetch('varaktighet', nil),
@@ -56,6 +59,7 @@ module Arbetsformedlingen
         )
       end
 
+      # :nodoc:
       def self.build_application(data)
         Values::Application.new(
           reference: data['referens'],
@@ -66,6 +70,7 @@ module Arbetsformedlingen
         )
       end
 
+      # :nodoc:
       def self.build_workplace(data)
         Values::Workplace.new(
           name: data.fetch('arbetsplatsnamn'),
@@ -82,6 +87,7 @@ module Arbetsformedlingen
         )
       end
 
+      # :nodoc:
       def self.build_postal(data)
         Values::Postal.new(
           code: data.fetch('postnummer', nil),
@@ -91,6 +97,7 @@ module Arbetsformedlingen
         )
       end
 
+      # :nodoc:
       def self.build_workplace_contacts(data)
         Values::Contact.new(
           name: data['namn'],
@@ -99,6 +106,7 @@ module Arbetsformedlingen
         )
       end
 
+      # :nodoc:
       def self.build_requirements(data)
         Values::Requirements.new(
           own_car: data.fetch('egenbil')

data/lib/arbetsformedlingen/api/soap_request.rb

@@ -30,7 +30,7 @@ module Arbetsformedlingen
       end
 
       # Performs a POST request
-      # @param [String] the post body
+      # @param [String] body
       # @return [Response] the response
       def post(body)
         http = Net::HTTP.new(uri.host, uri.port)
@@ -43,7 +43,7 @@ module Arbetsformedlingen
 
         response = http.request(request)
 
-        Response.new(response)
+        Response.new(response, uri)
       end
     end
   end

data/lib/arbetsformedlingen/api/taxonomy_client.rb

@@ -0,0 +1,797 @@
+# frozen_string_literal: true
+
+require 'arbetsformedlingen/api/base_soap_client'
+
+module Arbetsformedlingen
+  module API
+    # WsOccupation API client
+    # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx
+    class TaxonomyClient < BaseSOAPClient
+      # Service URL
+      SERVICE_URL = 'http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx'
+
+      # Namespace
+      NAMESPACE = 'urn:ams.se:Taxonomy'
+
+      # Initialize client
+      def initialize
+        super(SERVICE_URL, NAMESPACE)
+      end
+
+      # Returns occupation names
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllOccupationNames
+      def occupation_names(language_id:)
+        client_request('GetAllOccupationNames', args: { languageId: language_id })
+      end
+
+      # Returns AID occupation names
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllAIDOccupationNames
+      def aid_occupation_names
+        client_request('GetAllAIDOccupationNames')
+      end
+
+      # Returns continents
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllContinents
+      def continents(language_id:)
+        client_request('GetAllContinents', args: { languageId: language_id })
+      end
+
+      # Returns countries
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllCountries
+      def countries(language_id:)
+        client_request('GetAllCountries', args: { languageId: language_id })
+      end
+
+      # Returns drivers_licenses
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllDrivingLicences
+      def drivers_licenses(language_id:)
+        client_request('GetAllDrivingLicences', args: { languageId: language_id })
+      end
+
+      # Returns eu regions
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllEURegions
+      def eu_regions(language_id:)
+        client_request('GetAllEURegions', args: { languageId: language_id })
+      end
+
+      # Returns employment durations
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllEmploymentDurations
+      def employment_durations(language_id:)
+        client_request('GetAllEmploymentDurations', args: { languageId: language_id })
+      end
+
+      # Returns employment durations
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllEmploymentTypes
+      def employment_types(language_id:)
+        client_request('GetAllEmploymentTypes', args: { languageId: language_id })
+      end
+
+      # Returns experiences last
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllExperiencesLast
+      def experiences_last(language_id:)
+        client_request('GetAllExperiencesLast', args: { languageId: language_id })
+      end
+
+      # Returns experiences year
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllExperiencesYear
+      def experiences_year(language_id:)
+        client_request('GetAllExperiencesYear', args: { languageId: language_id })
+      end
+
+      # Returns AIDO occupation names
+      # @param label [String]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAIDOccupationNameByLabel
+      def aido_occupation_names(label:)
+        client_request('GetAIDOccupationNameByLabel', args: { label: label })
+      end
+
+      # Returns internal job situations
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllInternalJobSituations
+      def internal_job_situations
+        client_request('GetAllInternalJobSituations')
+      end
+
+      # Returns job situations
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllJobSituations
+      def job_situations(language_id:)
+        client_request('GetAllJobSituations', args: { languageId: language_id })
+      end
+
+      # Returns language_levels
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLanguageLevels
+      def language_levels(language_id:)
+        client_request('GetAllLanguageLevels', args: { languageId: language_id })
+      end
+
+      # Returns languages
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLanguages
+      def languages(language_id:)
+        client_request('GetAllLanguages', args: { languageId: language_id })
+      end
+
+      # Returns languages with ISO
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLanguagesWithISO
+      def languages_with_iso(language_id:)
+        client_request('GetAllLanguagesWithISO', args: { languageId: language_id })
+      end
+
+      # Returns locale fields
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLanguagesWithISO
+      def locale_fields(language_id:)
+        client_request('GetAllLocaleFields', args: { languageId: language_id })
+      end
+
+      # Returns locale group skills
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLocaleGroupSkills
+      def locale_group_skills
+        client_request('GetAllLocaleGroupSkills')
+      end
+
+      # Returns locale groups
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLocaleGroups
+      def locale_groups(language_id:)
+        client_request('GetAllLocaleGroups', args: { languageId: language_id })
+      end
+
+      # Returns locale groups
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllLocaleLevel3
+      def locale_level3(language_id:)
+        client_request('GetAllLocaleLevel3', args: { languageId: language_id })
+      end
+
+      # Returns municipalities
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllMunicipalities
+      def municipalities(language_id:)
+        client_request('GetAllMunicipalities', args: { languageId: language_id })
+      end
+
+      # Returns municipality homepages
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllMunicipalityHomePages
+      def municipality_homepages
+        client_request('GetAllMunicipalityHomePages')
+      end
+
+      # Returns occupation name synonyms
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllOccupationNameSynonyms
+      def occupation_name_synonyms(language_id:)
+        client_request('GetAllOccupationNameSynonyms', args: { languageId: language_id })
+      end
+
+      # Returns occupation name versions
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllOccupationNameSynonyms
+      def occupation_name_versions(language_id:)
+        client_request('GetAllOccupationNamesVersion', args: { languageId: language_id })
+      end
+
+      # Returns post codes
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllPostCodes
+      def post_codes(language_id:)
+        client_request('GetAllPostCodes', args: { languageId: language_id })
+      end
+
+      # Returns post localities
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllPostLocalities
+      def post_localities(language_id:)
+        client_request('GetAllPostLocalities', args: { languageId: language_id })
+      end
+
+      # Returns SNI level 1
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSNILevel1
+      def sni_level1(language_id:)
+        client_request('GetAllSNILevel1', args: { languageId: language_id })
+      end
+
+      # Returns SNI level 2
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSNILevel2
+      def sni_level2(language_id:)
+        client_request('GetAllSNILevel2', args: { languageId: language_id })
+      end
+
+      # Returns SUN field 1
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSUNField1
+      def sun_field1(language_id:)
+        client_request('GetAllSUNField1', args: { languageId: language_id })
+      end
+
+      # Returns SUN field 2
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSUNField2
+      def sun_field2(language_id:)
+        client_request('GetAllSUNField2', args: { languageId: language_id })
+      end
+
+      # Returns SUN field 3
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSUNField3
+      def sun_field3(language_id:)
+        client_request('GetAllSUNField3', args: { languageId: language_id })
+      end
+
+      # Returns SUN level 1
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSUNLevel1
+      def sun_level1(language_id:)
+        client_request('GetAllSUNLevel1', args: { languageId: language_id })
+      end
+
+      # Returns SUN level 2
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSUNLevel2
+      def sun_level2(language_id:)
+        client_request('GetAllSUNLevel2', args: { languageId: language_id })
+      end
+
+      # Returns SUN level 3
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSUNLevel3
+      def sun_level3(language_id:)
+        client_request('GetAllSUNLevel3', args: { languageId: language_id })
+      end
+
+      # Returns skill headlines
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSkillHeadlines
+      def skill_headlines(language_id:)
+        client_request('GetAllSkillHeadlines', args: { languageId: language_id })
+      end
+
+      # Returns skill main headlines
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSkillMainHeadlines
+      def skill_main_headlines(language_id:)
+        client_request('GetAllSkillMainHeadlines', args: { languageId: language_id })
+      end
+
+      # Returns skills
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSkills
+      def skills(language_id:)
+        client_request('GetAllSkills', args: { languageId: language_id })
+      end
+
+      # Returns skill versions
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllSkillsVersion
+      def skill_versions(language_id:)
+        client_request('GetAllSkillsVersion', args: { languageId: language_id })
+      end
+
+      # Returns unemployment benefit societies
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllUnemploymentBenefitSocieties
+      def unemployment_benefit_societies(language_id:)
+        client_request('GetAllUnemploymentBenefitSocieties', args: { languageId: language_id })
+      end
+
+      # Returns unemployment benefit societies
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllWageTypes
+      def wage_types(language_id:)
+        client_request('GetAllWageTypes', args: { languageId: language_id })
+      end
+
+      # Returns work time extents
+      # @return [Response] the response
+      # @param language_id [String, Integer]
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetAllWorkTimeExtents
+      def work_time_extents(language_id:)
+        client_request('GetAllWorkTimeExtents', args: { languageId: language_id })
+      end
+
+      # Returns EU regions by country
+      # @return [Response] the response
+      # @param language_id [String, Integer]
+      # @param country_id [String, Integer]
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetEURegionsByCountryID
+      def eu_regions_by_country(language_id:, country_id:)
+        args = { countryId: country_id, languageId: language_id }
+        client_request('GetEURegionsByCountryID', args: args)
+      end
+
+      # Returns ISCO by local code
+      # @param locale_code [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetISCOByLocaleCode
+      def isco_by_locale_code(locale_code:)
+        client_request('GetISCOByLocaleCode', args: { localeCode: locale_code })
+      end
+
+      # Returns ISCO by ISO2 code
+      # @param iso2_code [String]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLanguageIDByISO2Code
+      def isco_by_iso2_code(iso2_code:)
+        client_request('GetLanguageIDByISO2Code', args: { ISO2Code: iso2_code })
+      end
+
+      # Returns locale code by ISCO
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleCodeByISCO
+      def locale_code_by_isco(isco:)
+        client_request('GetLocaleCodeByISCO', args: { ISCO: isco })
+      end
+
+      # Returns locale fields by locale code
+      # @param language_id [String, Integer]
+      # @param locale_code [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleFieldsByLocaleCode
+      def locale_fields_by_locale_code(language_id:, locale_code:)
+        args = { languageId: language_id, localeCode: locale_code }
+        client_request('GetLocaleFieldsByLocaleCode', args: args)
+      end
+
+      # Returns locale fields by locale fields
+      # @param language_id [String, Integer]
+      # @param locale_field_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleFieldsByLocaleFieldIds
+      def locale_fields_by_locale_field_ids(language_id:, locale_field_ids:)
+        args = {
+          languageId: language_id,
+          localeFieldIds: locale_field_ids.map { |id| [:int, id] },
+        }
+        client_request('GetLocaleFieldsByLocaleFieldIds', args: args)
+      end
+
+      # Returns locale fields by text
+      # @param language_id [String, Integer]
+      # @param text [String]
+      # @param exact_match [true, false]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleFieldsByText
+      def locale_fields_by_text(language_id:, text:, exact_match: false)
+        args = { languageId: language_id, term: text, exactMatch: exact_match }
+        client_request('GetLocaleFieldsByText', args: args)
+      end
+
+      # Returns locale group by occupation name id
+      # @param language_id [String, Integer]
+      # @param occupation_name_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleGroupByOccupationNameId
+      def locale_group_by_occupation_name_id(language_id:, occupation_name_id:)
+        args = { languageId: language_id, occupationNameId: occupation_name_id }
+        client_request('GetLocaleGroupByOccupationNameId', args: args)
+      end
+
+      # Returns locale group skills by locale code
+      # @param locale_code [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleGroupSkillsByLocaleCode
+      def locale_group_skills_by_locale_code(locale_code:)
+        args = { localeCode: locale_code }
+        client_request('GetLocaleGroupSkillsByLocaleCode', args: args)
+      end
+
+      # Returns locale group skills by locale code
+      # @param language_id [String, Integer]
+      # @param locale_codes [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleGroupsByLocaleCodes
+      def locale_groups_by_locale_codes(language_id:, locale_codes:)
+        args = {
+          languageId: language_id,
+          localeCodes: locale_codes.map { |code| [:string, code] },
+        }
+        client_request('GetLocaleGroupsByLocaleCodes', args: args)
+      end
+
+      # Returns locale groups by locale field id
+      # @param language_id [String, Integer]
+      # @param locale_field_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleGroupsByLocaleFieldId
+      def locale_groups_by_locale_field_id(language_id:, locale_field_id:)
+        args = { languageId: language_id, localeFieldId: locale_field_id }
+        client_request('GetLocaleGroupsByLocaleFieldId', args: args)
+      end
+
+      # Returns locale groups by text
+      # @param language_id [String, Integer]
+      # @param text [String]
+      # @param exact_match [true, false]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetLocaleGroupsByText
+      def locale_groups_by_text(language_id:, text:, exact_match: false)
+        args = { languageId: language_id, term: text, exactMatch: exact_match }
+        client_request('GetLocaleGroupsByText', args: args)
+      end
+
+      # Returns occupation names for jobs with culture
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesArt
+      def occupation_names_art(language_id:)
+        client_request('GetOccupationNamesArt', args: { languageId: language_id })
+      end
+
+      # Returns occupation names by locale code
+      # @param language_id [String, Integer]
+      # @param locale_code [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesByLocaleCode
+      def occupation_names_by_locale_code(language_id:, locale_code:)
+        args = { languageId: language_id, localeCode: locale_code }
+        client_request('GetOccupationNamesByLocaleCode', args: args)
+      end
+
+      # Returns occupation names by occupation name ids
+      # @param language_id [String, Integer]
+      # @param occupation_name_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesByOccupationNameIds
+      def occupation_names_by_occupation_name_ids(language_id:, occupation_name_ids:)
+        args = {
+          languageId: language_id,
+          occupationNameIds: occupation_name_ids.map { |id| [:int, id] },
+        }
+        client_request('GetOccupationNamesByOccupationNameIds', args: args)
+      end
+
+      # Returns occupation names versions by occupation name ids
+      # @param language_id [String, Integer]
+      # @param occupation_name_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesByOccupationNameIdsVersion
+      def occupation_names_versions_by_occupation_name_ids(language_id:, occupation_name_ids:)
+        args = {
+          languageId: language_id,
+          occupationNameIds: occupation_name_ids.map { |id| [:int, id] },
+        }
+        client_request('GetOccupationNamesByOccupationNameIdsVersion', args: args)
+      end
+
+      # Returns occupation names by text
+      # @param language_id [String, Integer]
+      # @param text [String]
+      # @param exact_match [true, false]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesByText
+      def occupation_names_by_text(language_id:, text:, exact_match: false)
+        args = { languageId: language_id, term: text, exactMatch: exact_match }
+        client_request('GetOccupationNamesByText', args: args)
+      end
+
+      # Returns occupation names within construction
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesConstruction
+      def occupation_names_construction(language_id:)
+        args = { languageId: language_id }
+        client_request('GetOccupationNamesConstruction', args: args)
+      end
+
+      # Returns occupation names within navigation
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetOccupationNamesNavigation
+      def occupation_names_navigation(language_id:)
+        args = { languageId: language_id }
+        client_request('GetOccupationNamesNavigation', args: args)
+      end
+
+      # Returns post codes by municipality
+      # @param language_id [String, Integer]
+      # @param municipality_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetPostCodesByNationalNUTSLAU2Code
+      def post_codes_by_municipality(language_id:, municipality_id:)
+        args = { languageId: language_id, NUTSCode: municipality_id }
+        client_request('GetPostCodesByNationalNUTSLAU2Code', args: args)
+      end
+
+      # Returns post codes by post code
+      # @param language_id [String, Integer]
+      # @param post_code [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetPostCodesByPostCode
+      def post_codes_by_post_code(language_id:, post_code:)
+        args = { languageId: language_id, postCode: post_code }
+        client_request('GetPostCodesByPostCode', args: args)
+      end
+
+      # Returns post codes by post locality
+      # @param language_id [String, Integer]
+      # @param post_locality_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetPostCodesByPostLocality
+      def post_codes_by_post_locality(language_id:, post_locality_id:)
+        args = { languageId: language_id, postLocalityId: post_locality_id }
+        client_request('GetPostCodesByPostLocality', args: args)
+      end
+
+      # Returns post codes by post locality
+      # @param language_id [String, Integer]
+      # @param sun_level1_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSUNField3ByGuide
+      def sun_field3_by_guide(language_id:, sun_level1_id:)
+        args = { languageId: language_id, SUNLevel1ID: sun_level1_id }
+        client_request('GetSUNField3ByGuide', args: args)
+      end
+
+      # Returns SUN guide tree
+      # @param language_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSUNGuideTree
+      def sun_guide_tree(language_id:)
+        client_request('GetSUNGuideTree', args: { languageId: language_id })
+      end
+
+      # Returns skill headlines by main headline
+      # @param language_id [String, Integer]
+      # @param skill_headline_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillHeadlinesBySkillHeadlineIds
+      def skill_headlines_by_headline_ids(language_id:, skill_headline_ids:)
+        args = {
+          languageId: language_id,
+          skillHeadlineIds: skill_headline_ids.map { |id| [:int, id] },
+        }
+        client_request('GetSkillHeadlinesBySkillHeadlineIds', args: args)
+      end
+
+      # Returns skill headlines by main headline
+      # @param language_id [String, Integer]
+      # @param skill_main_headline_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillHeadlinesBySkillMainHeadlineId
+      def skill_headlines_by_main_headline(language_id:, skill_main_headline_id:)
+        args = { languageId: language_id, skillMainHeadlineId: skill_main_headline_id }
+        client_request('GetSkillHeadlinesBySkillMainHeadlineId', args: args)
+      end
+
+      # Returns skill headlines by text
+      # @param language_id [String, Integer]
+      # @param text [String]
+      # @param exact_match [true, false]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillHeadlinesByText
+      def skill_headlines_by_text(language_id:, text:, exact_match: false)
+        args = { languageId: language_id, term: text, exactMatch: exact_match }
+        client_request('GetSkillHeadlinesByText', args: args)
+      end
+
+      # Returns skill headlines by text
+      # @param language_id [String, Integer]
+      # @param skill_main_headline_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillMainHeadlinesBySkillMainHeadlineIds
+      def skill_headlines_by_skill_main_headlines_ids(language_id:, skill_main_headline_ids:)
+        args = {
+          languageId: language_id,
+          skillMainHeadlineIds: skill_main_headline_ids.map { |id| [:int, id] },
+        }
+        client_request('GetSkillMainHeadlinesBySkillMainHeadlineIds', args: args)
+      end
+
+      # Returns skill main headlines by text
+      # @param language_id [String, Integer]
+      # @param text [String]
+      # @param exact_match [true, false]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillMainHeadlinesByText
+      def skill_main_headlines_by_text(language_id:, text:, exact_match: false)
+        args = { languageId: language_id, term: text, exactMatch: exact_match }
+        client_request('GetSkillMainHeadlinesByText', args: args)
+      end
+
+      # Returns skills by locale code
+      # @param language_id [String, Integer]
+      # @param locale_code [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillsByLocaleCode
+      def skills_by_locale_code(language_id:, locale_code:)
+        # NOTE: Yes there is a typo, "localCode" instead of "localeCode", in the API
+        args = { languageId: language_id, localCode: locale_code }
+        client_request('GetSkillsByLocaleCode', args: args)
+      end
+
+      # Returns skills by main headline
+      # @param language_id [String, Integer]
+      # @param skill_headline_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillsBySkillHeadlineId
+      def skills_by_headline(language_id:, skill_headline_id:)
+        args = { languageId: language_id, skillHeadlineId: skill_headline_id }
+        client_request('GetSkillsBySkillHeadlineId', args: args)
+      end
+
+      # Returns skills by skill ids
+      # @param language_id [String, Integer]
+      # @param skill_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillsBySkillIds
+      def skills_by_skill_ids(language_id:, skill_ids:)
+        args = {
+          languageId: language_id,
+          skillIds: skill_ids.map { |id| [:int, id] },
+        }
+        client_request('GetSkillsBySkillIds', args: args)
+      end
+
+      # Returns skills versions by skill ids
+      # @param language_id [String, Integer]
+      # @param skill_ids [Array<String>, Array<Integer>]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillsBySkillIdsVersion
+      def skills_versions_by_skill_ids(language_id:, skill_ids:)
+        args = {
+          languageId: language_id,
+          skillIds: skill_ids.map { |id| [:int, id] },
+        }
+        client_request('GetSkillsBySkillIdsVersion', args: args)
+      end
+
+      # Returns skill headlines by main headline
+      # @param language_id [String, Integer]
+      # @param skill_main_headline_id [String, Integer]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillsBySkillMainHeadlineId
+      def skills_by_main_headline(language_id:, skill_main_headline_id:)
+        args = { languageId: language_id, skillMainHeadlineId: skill_main_headline_id }
+        client_request('GetSkillsBySkillMainHeadlineId', args: args)
+      end
+
+      # Returns skills by text
+      # @param language_id [String, Integer]
+      # @param text [String]
+      # @param exact_match [true, false]
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetSkillsByText
+      def skills_by_text(language_id:, text:, exact_match: false)
+        args = { languageId: language_id, term: text, exactMatch: exact_match }
+        client_request('GetSkillsByText', args: args)
+      end
+
+      # Returns version information
+      # @return [Response] the response
+      # @see Response
+      # @see http://api.arbetsformedlingen.se/taxonomi/v0/TaxonomiService.asmx?op=GetVersionInformations
+      def version_information
+        client_request('GetVersionInformations')
+      end
+    end
+  end
+end