# Departamentos

O departamento a ser selecionado na criação de vaga do candidato. Código é um campo aberto e opcional para uso de outros sistemas em caso de integração, sendo assim não existe validações neste campo.

## Create department

<mark style="color:green;">`POST`</mark> `https://api.acessorh.com.br/v1/department/json/:acc`

Cria um departamento na empresa selecionada.

#### Path Parameters

| Name | Type   | Description                             |
| ---- | ------ | --------------------------------------- |
| acc  | string | UID da empresa onde o cargo será criado |

#### Headers

| Name          | Type   | Description                                                   |
| ------------- | ------ | ------------------------------------------------------------- |
| Authorization | string | Token de acesso adquirido pela plataforma Identity (*bearer*) |

{% tabs %}
{% tab title="201 " %}

```
```

{% endtab %}
{% endtabs %}

* [Descrição do body JSON da requisição](#descricao-do-body-json-da-requisicao)
* [Exemplo de requisição](#exemplo-de-requisicao)

### Descrição do body JSON da requisição

| Chave                                                | Tipo   | Descrição              |
| ---------------------------------------------------- | ------ | ---------------------- |
| <p><strong>code</strong></p><p><em>required</em></p> | string | Código do departamento |
| <p><strong>name</strong></p><p><em>required</em></p> | string | Nome do departamento   |

### Exemplo de requisição

```javascript
{
	"code": "ti",
    "name": "Tecnologia da Informação"
}
```

## List departments

<mark style="color:blue;">`GET`</mark> `https://api.acessorh.com.br/v1/department/:acc`

Lista os departamentos da empresa selecionada.

#### Path Parameters

| Name | Type   | Description                                            |
| ---- | ------ | ------------------------------------------------------ |
| acc  | string | UID da empresa de onde os departamentos serão listados |

#### Query Parameters

| Name  | Type   | Description                                                 |
| ----- | ------ | ----------------------------------------------------------- |
| limit | string | Limite de departamentos que serão listados (paginação)      |
| skip  | string | Indica a quantidade de cargos que serão pulados (paginação) |
| code  | string | Código do departamento a ser filtrado                       |

#### Headers

| Name          | Type   | Description                                                      |
| ------------- | ------ | ---------------------------------------------------------------- |
| Authorization | string | Token de acesso adquirido pela plataforma de Identity *(bearer)* |

{% tabs %}
{% tab title="200 " %}

```javascript
[
    {
        "acc": "2d9174c4-06b7-4956-a5dc-8824d8a2f49e",
        "code": "financ",
        "id": "2f642a78-8fa7-4a05-8bb3-b6d25ddbd6fa",
        "name": "Financeiro"
    }
]
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Caso não seja inserido os parâmetros `limit` e `skip` , os valores padrões serão, respectivamente, 1000 e 0.

O parâmetro `limit` tem o seu valor máximo como 1000.
{% endhint %}

## Delete department

<mark style="color:red;">`DELETE`</mark> `https://api.acessorh.com.br/v1/department`

Deleta um departamento da empresa selecionada.

#### Query Parameters

| Name | Type   | Description                                          |
| ---- | ------ | ---------------------------------------------------- |
| uid  | string | UID do departamento a ser deletado.                  |
| acc  | string | UID da empresa de onde o departamento será deletado. |

#### Headers

| Name          | Type   | Description                                                    |
| ------------- | ------ | -------------------------------------------------------------- |
| Authorization | string | Token de acesso adquirido pela plataforma Identity *(bearer)*. |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}