Job

Job related methods

Get

Returns a specific job

https://api.itjobs.pt/job/get.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The requested job id (integer)
CURL example
$ curl --data "api_key=xxx&id=125378" http://api.itjobs.pt/job/get.json
Return values on success
{  
   "id":125378,
   "company":{  
      "id":2043,
      "name":"Bee Engineering - build together",
      "logo":"https:\/\/static.itjobs.pt\/images\/companies\/d7\/9c6\/2043\/logo.png",
      "description":"...",
      "phone":"213137691 ",
      "email":"[email protected]",
      "url":"http:\/\/www.bee-eng.pt",
      "slug":"bee-engineering-build-together"
   },
   "companyId":2043,
   "title":"Consultor Ruby on Rails",
   "body":"...",
   "ref":"",
   "wage":null,
   "types":[  
      {  
         "id":"1",
         "name":"Full Time"
      }
   ],
   "locations":[  
      {  
         "id":"14",
         "name":"Lisboa"
      }
   ],
   "allowRemote:":true,
   "publishedAt":"2015-06-23 10:28:33",
   "updatedAt":"2015-06-23 10:28:33",
   "slug":"consultor-ruby-on-rails"
}
Return values on error
{  
   "error":{  
      "message":"Job not found."
   }
}

List

Returns a list of jobs

https://api.itjobs.pt/job/list.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
limit No Number of results (integer)
page No Page number (integer)
company No Filter results by company (comma separated integers)
type No Filter results by type (comma separated integers)
contract No Filter results by contract (comma separated integers)
CURL example
$ curl --data "api_key=xxx&limit=2" http://api.itjobs.pt/job/list.json
Return values on success
{  
   "total":2449,
   "page":1,
   "limit":2,
   "results":[  
      {  
         "id":127166,
         "company":{  
            "id":2328,
            "name":"AskBlue",
            "logo":"https:\/\/static.itjobs.pt\/images\/companies\/fd\/69d\/2328\/logo.png",
            "description":"...",
            "address":"Av. Estados Unidos da Am\u00e9rica, 102 - 7\u00ba E\r\n1700-179 Lisboa",
            "phone":"+(351) 217 960 456",
            "email":"[email protected]",
            "url":"http:\/\/www.askblue.pt",
            "slug":"askblue"
         },
         "companyId":2328,
         "title":" Programador C# e PHP",
         "body":"...",
         "ref":" #5689409",
         "wage":null,
         "types":[  
            {  
               "id":"1",
               "name":"Full Time"
            }
         ],
         "locations":[  
            {  
               "id":"14",
               "name":"Lisboa"
            }
         ],
         "publishedAt":"2015-07-06 13:37:20",
         "updatedAt":"2015-07-06 13:37:20",
         "slug":"programador-c-e-php"
      },
      {  
         "id":127163,
         "company":{  
            "id":457,
            "name":"BABEL - Sistemas de Informa\u00e7\u00e3o",
            "logo":"https:\/\/static.itjobs.pt\/images\/companies\/42\/998\/457\/logo.png",
            "description":"...",
            "address":"Av. da Rep\u00fablica, 90\/96, Galeria \u2013 Frac\u00e7\u00e3o 3",
            "phone":217615810,
            "fax":217615819,
            "email":"[email protected]",
            "url":"http:\/\/www.babel.es",
            "slug":"babel-sistemas-de-informacao"
         },
         "companyId":457,
         "title":"Consultor Especialista em Usabilidade",
         "body":"...",
         "ref":"BABELPT15_ITJUsuab",
         "wage":null,
         "types":[  
            {  
               "id":"1",
               "name":"Full Time"
            }
         ],
         "locations":[  
            {  
               "id":"14",
               "name":"Lisboa"
            }
         ],
         "publishedAt":"2015-07-06 13:37:03",
         "updatedAt":"2015-07-06 13:37:03",
         "slug":"consultor-especialista-em-usabilidade"
      }
   ]
}

Create

Creates a job ad on the site
This operation is reserved for companies registered on the site. Please refer to your own API KEYs

https://api.itjobs.pt/job/create.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
title Yes Job title (string)
body Yes Job text (string)
location No Job location (comma separated integers)
contract No Job contract (comma separated integers)
type No Job type (comma separated integers)
remote No Allow remote work (float)
ref No Job reference (string)
wage No Annual gross salary (integer)

The body parameter listed above should contain the text ad and can(should) use HTML to format it's layout.
The accepeted tags are 'p', 'strong', 'br', 'em', 'u', 'strike', 'ol', 'li', 'ul', 'a', 'b'. Tags attributes accepted are 'text-align'.

CURL example
$ curl --data "api_key=xxx&title=Developer&body=<p>Your content</p>&ref=ITJ&location=1" http://api.itjobs.pt/job/create.json
Return values on success
{  
   "success":{  
      "message":"Job created successfully. You can check status at \/job\/status or your company dashboard.",
      "id":"127176"
   }
}
Return values on error
{  
   "error":{  
      "message":"Not allowed. Please contact support."
   }
}

Edit

Edits a job ad on the site
This operation is reserved for companies registered on the site. Please refer to your own API KEYs

https://api.itjobs.pt/job/edit.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The job id (integer)
title No Job title (string)
body No Job text (string)
location No Job location (comma separated integers)
contract No Job contract (comma separated integers)
type No Job type (comma separated integers)
ref No Job reference (string)
wage No Annual gross salary (integer)

The body parameter listed above should contain the text ad and can(should) use HTML to format it's layout.
The accepeted tags are 'p', 'strong', 'br', 'em', 'u', 'strike', 'ol', 'li', 'ul', 'a', 'b'. Tags attributes accepted are 'text-align'.

CURL example
$ curl --data "api_key=xxx&id=127176&title=Developer&body=<p>Your content</p>&ref=ITJ&location=1" http://api.itjobs.pt/job/edit.json
Return values on success
{  
   "success":{  
      "message":"Job edited successfully. You can check status at \/job\/status or your company dashboard",
      "id":"127176"
   }
}
Return values on error
{  
   "error":{  
      "message":"Not allowed. Please contact support."
   }
}

Status

Checks the status on specific job ad
This operation is reserved for companies registered on the site. Please refer to your own API KEYs

https://api.itjobs.pt/job/status.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The job id (integer)
CURL example
$ curl --data "api_key=xxx&id=127176" http://api.itjobs.pt/job/status.json
Return values on success
{
    "success": {
        "status": {
            "id": "2",
            "name": "moderation"
        }
    }
}
        
Return values on error
{  
   "error":{  
      "message":"Job not found."
   }
}

Suspend

Suspends/removes a job ad on the site
This operation is reserved for companies registered on the site. Please refer to your own API KEYs

https://api.itjobs.pt/job/suspend.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The job id (integer)
CURL example
$ curl --data "api_key=xxx&id=127176" http://api.itjobs.pt/job/suspend.json
Return values on success
{  
   "success":{  
      "message":"Job suspeded successfully. You can check status at /job/status or your company dashboard.",
      "id":"127176"
   }
}
Return values on error
{  
   "error":{  
      "message":"Job not found."
   }
}

Appendix

Information regardng Job type, contract annd location

Type
Id Description
1 Full-time
2 Part-time
Contract
Id Description
5 Estágio académico
4 Prestação de Serviços
3 Estágio profissional
2 Contrato sem termo
1 Contrato a termo
Location
Id Description
2 Açores
1 Aveiro
3 Beja
4 Braga
5 Bragança
6 Castelo Branco
8 Coimbra
10 Évora
9 Faro
11 Guarda
29 Internacional
13 Leiria
14 Lisboa
15 Madeira
12 Portalegre
18 Porto
20 Santarém
17 Setúbal
22 Viana do Castelo
21 Vila Real
16 Viseu