> For the complete documentation index, see [llms.txt](https://acessorh.gitbook.io/project/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://acessorh.gitbook.io/project/api/arquivos.md).

# Arquivos

Upload de arquivos temporários, download e conversão de documentos e imagens.

Todas as chamadas de arquivo utilizam o Path (caminho do diretório onde está armazenado o arquivo) como referência. No caso de uma chamada PUT, é utilizado o Path da máquina onde encontra-se armazenado (Exemplo: C:\Computador\Downloads\Arquivo.pdf). Já nas chamadas de GET, utiliza-se o Path do diretório do Acesso RH, que pode ser encontrado na chamada [Get Position](/project/api/posicoes.md#get-position) (Exemplo: "individual/23bcac75-5722-4e14-96a4-72f69322671e/document/7d58e6f3-5201-40b3-b1fb-3e6949d19960/362f2533-b537-4a99-2329-7b56ffb77bfa.jpg")

No caso de precisar enviar um arquivo em alguma chamada (Exemplo: Guia do Exame Médico durante a criação de uma Posição) é necessário que seja feito o upload do arquivo por antecedência e em seguida, seja referenciado na chamada de [Create Position](/project/api/posicoes.md#create-position) usando o UID enviado na response.

Ao realizar o upload de um arquivo, ele permanecerá armazenado por até 15 minutos para que o UID de resposta possa ser utilizado em uma próxima requisição. Caso o UID retornado não seja utilizado durante este tempo, o arquivo será excluído.

{% hint style="success" %}
As requisições podem ser realizadas em paralelo, mesmo que para a mesma posição, no intuito de reduzir o tempo total de transferência de arquivos.
{% endhint %}

## Upload file

<mark style="color:orange;">`PUT`</mark> `https://api.acessorh.com.br/v1/upload`

Upload de arquivos temporários

#### Headers

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

#### Request Body

| Name | Type   | Description                        |
| ---- | ------ | ---------------------------------- |
| file | string | Path do arquivo que será carregado |

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

```javascript
"bcaaf3a8-b682-4809-83a7-83a73e867cb6"
```

{% endtab %}
{% endtabs %}

## Get a raw file

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

Download de imagens e/ou arquivos no formato original.

#### Path Parameters

| Name | Type   | Description                 |
| ---- | ------ | --------------------------- |
| path | string | Caminho do arquivo desejado |

#### Headers

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

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

```
```

{% endtab %}
{% endtabs %}

## Get a transformed file

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

Download de imagens modificadas pelos parâmetros selecionados.

#### Path Parameters

| Name    | Type   | Description                      |
| ------- | ------ | -------------------------------- |
| options | string | Opções de modificação do arquivo |
| path    | string | Caminho do arquivo desejado      |

#### Headers

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

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

```
```

{% endtab %}
{% endtabs %}

#### Opções de tamanho e qualidade do arquivo

* **1000x** - tamanho horizontal em pixels da imagem;
* **1000y** - tamanho vertical em pixels da imagem;
* **80q** - diminui a qualidade da imagem para 80%.

{% hint style="info" %}
Os valores acima são apenas exemplos e podem ser alterados.&#x20;

O valor `t` funciona apenas para arquivos de imagens. Caso queira alterar o tamanho da imagem mantendo a proporção, utilize apenas um dos parâmetros x ou y.
{% endhint %}

## Get a converted file

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

Download de imagens convertidas no formato desejado.

#### Path Parameters

| Name   | Type   | Description                               |
| ------ | ------ | ----------------------------------------- |
| format | string | Formato no qual o arquivo será convertido |
| path   | string | Caminho do arquivo desejado               |

#### Headers

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

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

```
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Arquivos de imagem podem ser convertidas em apenas uma opção: PDF.
{% endhint %}