firstjob_api 1.0.4

data/lib/data/english_levels.yaml

@@ -0,0 +1,5 @@
+english_levels:
+  1: basico
+  2: medio
+  3: avanzado
+  4: nativo

data/lib/data/excel_levels.yaml

@@ -0,0 +1,5 @@
+excel_levels:
+  1: No aplica
+  2: Basico
+  3: Medio
+  4: Avanzado

data/lib/data/looking_fors.yaml

@@ -0,0 +1,4 @@
+looking_fors:
+  1: Practica
+  2: Memoria
+  3: Trabajo

data/lib/data/universities.yaml

@@ -0,0 +1,121 @@
+universities:
+  2:  Universidad de Chile
+  3:  Universidad Técnica Federico Santa María (UTFSM)
+  4:  Universidad Adolfo Ibáñez (UAI)
+  5:  Universidad de los Andes
+  6:  Universidad de Santiago de Chile (USACH)
+  7:  Universidad Diego Portales (UDP)
+  9:  Universidad del desarrollo (UDD)
+  10:  Universidad de Concepción
+  11:  INACAP
+  12:  DUOC UC
+  96:  Instituto Profesional Esucomex
+  171:  Universidad Santo Tomás (UST)
+  170:  Universidad San Sebastián (USS)
+  110:  Instituto Profesional Providencia
+  116:  Universidad Arturo Prat (UNAP)
+  117:  Universidad Austral de Chile
+  123:  Universidad de Atacama
+  119:  Universidad Católica de Temuco (UCT)
+  120:  Universidad Católica del Maule (UCM)
+  122:  Universidad de Antofagasta
+  121:  Universidad Católica del Norte (UCN)
+  127:  Universidad de la Serena
+  128:  Universidad de Los Lagos
+  129:  Universidad de Magallanes
+  132:  Universidad de Talca
+  133:  Universidad de Tarapacá
+  134:  Universidad de Valparaíso
+  135:  Universidad del Bío-Bío
+  138:  Universidad Tecnológica Metropolitana  (UTEM)
+  139:  Universidad Academia de Humanismo Cristiano
+  141:  Universidad Adventista de Chile
+  142:  Universidad Alberto Hurtado (UAH)
+  143:  Universidad Autónoma de Chile
+  144:  Universidad Bernardo O'Higgins (UBO)
+  147:  Universidad Central de Chile
+  146:  Universidad Católica Cardenal Silva Henríquez
+  152:  Universidad de Las Américas (UDLA)
+  154:  Universidad de Viña del Mar
+  149:  Universidad de Aconcagua
+  151:  Universidad de Artes, Ciencias y Comunicación (UNIACC)
+  156:  Universidad del Mar
+  157:  Universidad del Pacífico
+  145:  Universidad Bolivariana
+  148:  Universidad Chileno Británica de Cultura
+  159:  Universidad Finis Terrae
+  160:  Universidad Gabriela Mistral (UGM)
+  161:  Universidad Iberoamericana de Ciencias y Tecnología (UNICIT)
+  162:  Universidad Internacional SEK
+  163:  Universidad La Araucana
+  164:  Universidad La República
+  166:  Universidad Mayor
+  167:  Universidad Miguel de Cervantes
+  169:  Universidad Pedro de Valdivia
+  108:  Instituto Profesional Los Leones
+  1:  Pontificia Universidad Católica de Chile (PUC)
+  8:  Pontificia Universidad Católica de Valparaíso (PUCV)
+  173:  Universidad de Ciencias de la Informática (UCINF)
+  126:  Universidad de la Frontera (UFRO)
+  130:  Universidad de Playa Ancha de Ciencias de la Educación (UPLA)
+  155:  Universidad Católica de la Santísima Concepción (UCSC)
+  1627:  Escuela de Comercio de Santiago
+  1626:  Instituto Tecnológico de Chile (ITC)
+  1628:  Instituto de Estudios Bancarios Guillermo Subercaseaux (IEB)
+  1624:  Instituto Profesional de Chile
+  1623:  AIEP
+  1625:  INSEC
+  136:  Universidad Metropolitana de Ciencias de la Educación (UMCE)
+  150:  Universidad de Arte y Ciencias Sociales (UARCIS)
+  168:  Universidad Nacional Andrés Bello (UNAB)
+  1862:  Instituto Profesional Los Lagos
+  1868:  Manpower
+  2033:  Instituto Profesional Virginio Gómez
+  2034:  Instituto Profesional Valle Central
+  2035:  Universidad Tecnólogica de Chile
+  2037:  Instituto Profesional La Araucana
+  2039:  CFT San Agustín de Talca
+  2040:  CFT Santiago
+  2041:  CFT UCEVALPO
+  2042:  Instituto Profesional Iplacex
+  2043:  CFT Santo Tomás
+  2036:  Instituto Profesional Arcos
+  2044:  Instituto Profesional Santo Tomás
+  2045:  Centro de Formación Técnica del Medio Ambiente (IDMA)
+  2049:  Escuela Internacional de Estética Integral Germaine de Capuccini
+  2050:  Instituto Profesional EATRI
+  2038:  Instituto Chileno Norteamericano
+  2053:  Instituto Profesional CIISA
+  2054:  Instituto Profesional ICEL
+  2058:  Escuela de Imagen y Comunicación Alpes
+  2059:  CFT Enac
+  2060:  CFT Prodata
+  2061:  Instituto Internacional de Artes Culinarias y Servicio - Culinary
+  2064:  CFT ProAndes‎
+  2068:   Instituto Benjamín Teplizky 
+  2069:  Ceduc UCN
+  2070:  CFT Lota Arauco
+  2071:  Instituto Profesional CENAFOM
+  2072:  CFT Cenco Quillota
+  2073:  Escuela de Contadores Auditores de Santiago
+  2074:  Instituto Profesional Diego Portales
+  2075:  Instituto Superior Alemán de Comercio (INSALCO)
+  2078:  Instituto Profesional IPG
+  2081:  Instituto Profesional Vertical
+  2091:  Universidad Los Leones
+  2092:  I.P. LATINOAMERICANO DE COMERCIO EXTERIOR
+  2093:  I.P. IACC
+  2094:  I.P. CÁMARA DE COMERCIO DE SANTIAGO
+  2095:   I.P. DE CIENCIAS Y ARTES INCA-CEA
+  2096:  C.F.T. IPROSEC 
+  2097:  C.F.T. DE TARAPACÁ
+  2098:  C.F.T. ANDRÉS BELLO
+  2099:  C.F.T. INACAP
+  2100:  I.P. CARLOS CASANUEVA
+  2101:  C.F.T. JUAN BOHON
+  2102:  C.F.T. CÁMARA DE COMERCIO DE SANTIAGO
+  2103:  I.P. IPEGE
+  2104:  C.F.T. DEL MAULE
+  2105:  C.F.T. PROTEC
+  2106:   C.F.T. MASSACHUSETTS
+  2107:  U. DE PLAYA ANCHA DE CIENCIAS DE LA EDUCACIÓN

data/lib/firstjob_api.rb

@@ -0,0 +1,142 @@
+require 'rails'
+require 'time'
+require 'httparty'
+require 'erb'
+
+require 'firstjob_api/university'
+require 'firstjob_api/career'
+require 'firstjob_api/career_status'
+require 'firstjob_api/english_level'
+require 'firstjob_api/excel_level'
+require 'firstjob_api/looking_for'
+require 'firstjob_api/university'
+require 'firstjob_api/publication'
+require 'firstjob_api/http_parser'
+
+module FirstjobApi
+  include HTTParty
+  base_uri 'https://api.firstjob.com'
+
+  # API login configuration, need initialization setup to work
+  mattr_accessor :grant_type
+  @@grant_type = "password"
+
+  mattr_accessor :client_id
+  @@client_id = nil
+
+  mattr_accessor :username
+  @@username = nil
+
+  mattr_accessor :email
+  @@email    = nil
+
+  mattr_accessor :password
+  @@password    = nil
+
+  mattr_accessor :access_token
+  @@access_token = nil
+
+  @@token_type= nil
+
+  mattr_accessor :expires_in
+  @@expires_in = nil
+
+  mattr_accessor :access_token_updated_at
+  @@access_token_updated_at = nil
+
+  mattr_accessor :options
+  @@options = nil
+
+  mattr_accessor :body
+  @@body = nil
+
+  mattr_accessor :last_request
+  mattr_accessor :last_response
+  @@last_request = nil
+  @@last_response = nil
+
+  @@try_counter = 0
+  
+
+  # Default way to setup FirstjobApi.
+  def self.setup
+    yield self
+    # It does not use basic http auth, it passes the username and password in the body of the request...
+    #@@options = {headers: { "Accept" => "application/json", "Content-Type" => "application/json"}, basic_auth: {username: @@username, password: @@password}}
+    @@options = {headers: { "Accept" => "application/json", "Content-Type" => "application/json"}}
+    @@body = {username: @@username, password: @@password}
+  end
+
+  # Publicaciones
+  # creates and publish a publication
+  def self.publish(params)
+    publication = FirstjobApi::Publication.create(params)
+    return publication
+  end
+
+  def self.update_publication(publication_id, json)
+    update_publication_path = "/v0/empresas/avisos/#{publication_id}"
+    response = self.post(update_publication_path, @@options.merge(body: json, headers: { "Accept" => "application/json", "Content-Type" => "application/json"}))
+
+    if HttpParser.parse_response(response)
+      case response.code
+        when 201
+          # "Publication updated, All good!"
+          return response # body contains id del proceso publicado
+        when 200
+          # "TODO: Uhm.. no idea, is this good?"
+          return response # body contains id del proceso publicado?
+      end
+    end
+  end
+
+  def self.publish_publication(publication_id, pais_id, plan_publication_id)
+    publish_publication_path = "/v0/empresas/avisos/#{publication_id}/publicacion/#{plan_publication_id}"
+    response = self.put(publish_publication_path, @@options.merge(query: @@options[:query].merge({paisId: pais_id})))
+
+    if HttpParser.parse_response(response)
+      case response.code
+        when 201
+          # "Publication created, All good!"
+          return response # body contains id del proceso publicado
+        when 200
+          # "TODO: Uhm.. no idea, is this good?"
+          return response # body contains id del proceso publicado?
+      end
+    end
+  end
+
+  def self.get_publication_url(publication_id)
+    "http://www.laborum.cl/empleos/#{publication_id}.html"
+  end
+
+  def self.get_publication(publication_id)
+    get_publication_path = "/v0/empresas/avisos/#{publication_id}"
+    response = self.get(get_publication_path, @@options)
+
+    return HttpParser.parse_response_to_json(response)
+  end
+
+  def self.get_postulations_in_publication(publication_id, page=0, postulations_per_page=20)
+    get_postulations_in_publication_path = "/v0/empresas/avisos/#{publication_id}/postulaciones"
+    response = self.get(get_postulations_in_publication_path, @@options.merge(query: @@options[:query].merge({page: page, perPage: postulations_per_page})))
+
+    return HttpParser.parse_response_to_json(response)
+  end
+
+  def self.get_postulation(postulation_id)
+    get_postulation_path = "/v0/empresas/postulaciones/#{postulation_id}"
+    response = self.get(get_postulation_path, @@options)
+
+    return HttpParser.parse_response_to_json(response)
+  end
+
+  def self.destroy_publication(publication_id)
+    destroy_publication_path = "/v0/empresas/avisos/#{publication_id}"
+    response = self.delete(destroy_publication_path, @@options)
+
+    return HttpParser.parse_response(response)
+  end
+
+end
+

data/lib/firstjob_api/career.rb

@@ -0,0 +1,15 @@
+module FirstjobApi
+  class Career
+    CAREERS = YAML.load_file(File.join(File.dirname(__FILE__),"../data/careers.yaml"))["careers"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      CAREERS
+    end
+
+    # Poor's man find
+    def self.find(id)
+      CAREERS[id]
+    end
+  end
+end

data/lib/firstjob_api/career_status.rb

@@ -0,0 +1,15 @@
+module FirstjobApi
+  class CareerStatus
+    CAREER_STATUSES = YAML.load_file(File.join(File.dirname(__FILE__),"../data/career_statuses.yaml"))["career_statuses"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      CAREER_STATUSES
+    end
+
+    # Poor's man find
+    def self.find(id)
+      CAREER_STATUSES[id]
+    end
+  end
+end

data/lib/firstjob_api/english_level.rb

@@ -0,0 +1,15 @@
+module FirstjobApi
+  class EnglishLevel
+    ENGLISH_LEVELS = YAML.load_file(File.join(File.dirname(__FILE__),"../data/english_levels.yaml"))["english_levels"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      ENGLISH_LEVELS
+    end
+
+    # Poor's man find
+    def self.find(id)
+      ENGLISH_LEVELS[id]
+    end
+  end
+end

data/lib/firstjob_api/excel_level.rb

@@ -0,0 +1,15 @@
+module FirstjobApi
+  class ExcelLevel
+    EXCEL_LEVELS = YAML.load_file(File.join(File.dirname(__FILE__),"../data/excel_levels.yaml"))["excel_levels"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      EXCEL_LEVELS
+    end
+
+    # Poor's man find
+    def self.find(id)
+      EXCEL_LEVELS[id]
+    end
+  end
+end

data/lib/firstjob_api/http_parser.rb

@@ -0,0 +1,49 @@
+module FirstjobApi
+  class HttpParser
+    def self.parse_json_to_hash(json, hash)
+      json.each{|object| hash[object["id"]] ? hash[object["id"]].merge!(object) : hash[object["id"]] = object}
+      return hash
+    end
+
+    def self.parse_response(response)
+      FirstjobApi.last_response = response
+      FirstjobApi.last_request = response.request
+      case response.code
+        when 200..201
+          # "All good!"
+          return response.body
+        when 401
+          FirstjobApi.invalidate_access_token!
+          raise "Error 401: Unauthorized. Check login info.\n #{response.body}"
+        when 403
+          raise "Error 403: Forbidden"
+        when 404
+          raise "Error 404 not found"
+        when 500...600
+          raise "ZOMG ERROR #{response.code}: #{response.request.path}, #{response.body}"
+        else
+          raise "Error #{response.code}, unkown response: #{response.request.path}, #{response.body}"
+      end
+    end
+    def self.parse_json_response(response)
+      FirstjobApi.last_response = response
+      FirstjobApi.last_request = response.request
+      case response.code
+        when 200..201
+          # "All good!"
+          return JSON.parse(response.body)
+        when 401
+          FirstjobApi.invalidate_access_token!
+          raise "Error 401: Unauthorized. Check login info.\n #{response.body}"
+        when 403
+          raise "Error 403: Forbidden"
+        when 404
+          raise "Error 404 not found"
+        when 500...600
+          raise "ZOMG ERROR #{response.code}: #{response.request.path}, #{response.body}"
+        else
+          raise "Error #{response.code}, unkown response: #{response.request.path}, #{response.body}"
+      end
+    end
+  end
+end

data/lib/firstjob_api/looking_for.rb

@@ -0,0 +1,15 @@
+module FirstjobApi
+  class LookingFor
+    LOOKING_FORS = YAML.load_file(File.join(File.dirname(__FILE__),"../data/looking_fors.yaml"))["looking_fors"].symbolize_keys!
+
+    # Poor's man all
+    def self.all
+      LOOKING_FORS
+    end
+
+    # Poor's man find
+    def self.find(id)
+      LOOKING_FORS[id]
+    end
+  end
+end

data/lib/firstjob_api/publication.rb

@@ -0,0 +1,97 @@
+module FirstjobApi
+  class Publication
+    attr_accessor :title, :description, :career_status_id,
+      :looking_for_id, :location, :years_experience, :salary,
+      :english_level_id, :excel_level_id, :careers_ids,
+      :universities_ids, :id, :slug, :status, :postulantes
+  
+    def initialize(attributes={})
+      # Default values
+      @salary = 0
+      @location = "Chile"
+      @career_status_id = 1
+      @years_experience = 0
+      @english_level_id = 1
+      @excel_level_id = 1
+
+      attributes.each do |key, value|
+        self.send("#{key}=", value)
+      end
+    end
+
+    def body
+      default_publication_json()
+    end
+
+    def self.create(params)
+      publication = new(params)
+      response = publication.publish()
+    end
+
+    def publish
+      # Post publication
+      response = FirstjobApi.post("/api/publish_job",
+                               FirstjobApi.options.merge(
+                                 body: FirstjobApi.body.merge({publish_job: self.body}).to_json
+                                )
+                              )
+      response_body = HttpParser.parse_json_response(response)
+
+      # load results
+      @slug = response_body["slug"]
+      @id = response_body["id"]
+      @status = response_body["status"]
+      return self
+    end
+
+    def url
+      "#{FirstjobApi.base_uri}/jobs/#{slug}"
+    end
+
+    def postulants
+      # Get postulants
+      response = FirstjobApi.post("/api/get_applicants_job",
+                               FirstjobApi.options.merge(
+                                 body: FirstjobApi.body.merge({job_id: @id}).to_json
+                                )
+                              )
+      response_body = HttpParser.parse_json_response(response)
+
+      # load results
+      @postulantes = response_body["postulantes"]
+      return @postulantes
+    end
+
+    def destroy
+      response = FirstjobApi.post("/api/doregister_job",
+                               FirstjobApi.options.merge(
+                                 body: FirstjobApi.body.merge({job_id: id}).to_json
+                                )
+                              )
+      response_body = HttpParser.parse_response(response)
+    end
+  
+    private
+    def default_publication_json
+      hash = {
+        title:               title, # required
+        description:         description, # required, max 300 caracters
+        career_status:       career_status_id, # required
+        looking_for:         looking_for_id, # required
+        location:            location, # required
+        years_experience:    years_experience, # required, number
+        salary:              salary, # required, number. Can be 0
+        english_level:       english_level_id, # required, number 
+        excel_level:         excel_level_id, # required, number 
+      }
+      if careers_ids.present?
+        hash[:careers] = careers_ids   # optional, array or NOT PRESENT
+      end
+      if universities_ids.present?
+        hash[:universities] = universities_ids # optional, array or NOT PRESENT
+      end
+      return hash
+    end
+  
+  end
+end