# Autenticação

Primeiro passo para uso da API do Siprov é chamar o método [Autenticação (/ext/autenticacao)](/referencia-da-api/introducao-tecnica/autenticacao.md) para capturar sua chave de acesso. 

Você deve fazer um *POST* neste método passando o usuário e senha recebido como autenticação do tipo [Basic Auth](https://pt.stackoverflow.com/questions/254503/o-que-%C3%A9-basic-auth). 

#### Exemplo de requisição: 

{% code lineNumbers="true" %}

```shell
curl --request POST \
     --url https://acesso.siprov.com.br/siprov-api/ext/autenticacao \
     --header 'accept: text/plain' \
     --header 'authorization: Basic dGVzdGU6dGVzdGU='
```

{% endcode %}

Ao efetuar tal chamada, no retorno constará a chave (`authorizationToken`) que deverá ser usada na autenticação dos demais métodos. No caso, a autenticação então passa a ser do tipo Bearer Token. 

A chave gerada tem validade de 12 horas. Logo, esse método deve ser chamado recorrentemente para renovação da chave. 

Atente-se também que qualquer alteração efetuada na [configuração de acesso](/configuracao-do-acesso.md) implica obrigatoriamente na renovação da chave. 

Por fim, explicamos os demais campos que constaram no retorno desse método: 

* `codUsuario`: Código único do usuário autenticado na API;
* `nomeUsuario`: Nome do respectivo usuário;
* `codClienteSiprov`: Código único da empresa responsável pela base no sistema;
* `nomeClienteSiprov`: Nome da respectivo empresa; 
* `permissaoLoja`: Lista de unidades (ou loja), que geralmente são filiais ou regionais, liberadas nesse usuário;
  * `codLoja`: Código único da unidade (loja);
  * `nome`: Nome da unidade (loja).
* `plano`: Lista de planos liberados para esse usuário:
  * `codPlano`: Código único do plano;
  * `nome`: Nome do plano.


---

# 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://doc.siprov.com.br/guia-de-implementacao/autenticacao.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.