Biblioteca

Gupy

Serviços

Gerenciamento de vagas de trabalho.

Descrição

Permite a criação, listagem, atualização e exclusão de vagas de trabalho na API Gupy.

Uso

A library espera as seguintes informações:

  • Token de acesso à API Gupy
  • Dados referentes ao cargo de trabalho (job)
  • Dados referentes à vaga de trabalho (vacancy)
  • Tipo de "operation" (create, list ou update)

Endpoints dos serviços: 

GET em https://api.gupy.io/api/v1/jobs/{jobId}/vacancies
POST em https://api.gupy.io/api/v1/jobs/{jobId}/vacancies
PUT em https://api.gupy.io/api/v1/jobs/{jobId}/vacancies/{vacancyId}
DELETE em https://api.gupy.io/api/v1/jobs/{jobId}/vacancies/{vacancyId}

Listagem

Dados obrigatórios:

{
  "operation": "list",
  "header": {
    "Authorization": "Bearer 123abc"
  },
  "job": {
    "id": 123
  }
}

Criação

Dados obrigatórios:

{
  "operation": "create",
  "header": {
    "Authorization": "Bearer 123abc"
  },
  "job": {
    "id": 123
  },
  "vacancy": {
    "code": 456,
    "status": "string",
    "errorMessage": "string"     //Informar quando "status" = "error"
  }
}

Atualização

Dados obrigatórios:

{
  "operation": "update",
  "header": {
    "Authorization": "Bearer 123abc"
  },
  "job": {
    "id": 123
  },
  "vacancy": {
    "id": 456
    "code": "32154",
    "status": "string",
    "errorMessage": "string"     //Obrigatório quando status = error
  }
}

Deleção

Dados obrigatórios:

{
  "operation": "delete",
  "header": {
    "Authorization": "Bearer 123abc"
  },
  "job": {
    "id": 123
  },
  "vacancy": {
    "id": 456
  }
}

Resultado 

Sucesso POST

Saída:

{
  "status": 201,
  "body": {
    "id": 15319,
    "code": "32144",
    "status": "valid",
    "createdAt": "2019-08-26T16:38:22.678Z",
    "updatedAt": "2019-08-26T16:38:22.678Z",
    "errorMessage": null,
    "jobId": 71779
  },
  "headers": {
    "Connection": "keep-alive",
    "Content-Length": "156",
    "Content-Type": "application/json; charset=utf-8",
    "Date": "Mon, 26 Aug 2019 16:38:22 GMT",
    "ETag": "W/\"9c-497e4e9bLl5U52GJEY4ZLsnH+lE\"",
    "Server": "nginx/1.15.1",
    "Vary": "Accept-Encoding",
    "Via": "1.1 5ca0b47905... (CloudFront)",
    "X-Amz-Cf-Id": "-zwAMxrYCWPGu...Ca1g==",
    "X-Amz-Cf-Pop": "GRU1",
    "X-Cache": "Miss from cloudfront"
  },
  "message": "Vacancy criada com sucesso.",
  "success": true
}


Falha POST

Saída:

{
  "logger": {
    "error": "Error 400",
    "code": 400,
    "body": {
      "title": "Business Error",
      "detail": "For status=\"valid\", errorMessage must be null.",
      "status": 400
    },
    "headers": {
      "Connection": "keep-alive",
      "Content-Length": "99",
      "Content-Type": "application/json; charset=utf-8",
      "Date": "Mon, 26 Aug 2019 16:37:36 GMT",
      "ETag": "W/\"63-kgbxkObyMghZgQvN4vksbZwobFU\"",
      "Server": "nginx/1.15.1",
      "Vary": "Accept-Encoding",
      "Via": "1.1 5ca0b47905... (CloudFront)",
      "X-Amz-Cf-Id": "-zwAMxrYCWPGu...Ca1g==",
      "X-Amz-Cf-Pop": "GRU1",
      "X-Cache": "Miss from cloudfront"
    }
  },
  "message": "Erro ao criar Vacancy. Endpoint: API Gupy POST /jobs/{id}/vacancies",
  "success": false
}
Encontrou sua resposta?