# Arquivos

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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://acessorh.gitbook.io/project/api/arquivos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.