> For the complete documentation index, see [llms.txt](https://docs.peoplepass.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.peoplepass.com.br/integracoes/api/introducao.md).

# Autenticação

Com a nossa API é possível automatizar e integrar serviços e produtos na plataforma peoplepass.

A autenticação na API é feita utilizando [*HTTP Basic Auth*](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Authentication) através da utilização de uma chave de API. Esta chave serve para que o sistema identifique quem está fazendo a solicitação, verificar se há permissão para cada solicitação.

{% hint style="danger" %}
Os tokens são como senhas, uma vez que alguém tem acesso a eles, pode efetuar as mesmas ações e consultas que o usuário que a criou. Não inclua sua chave de API publicamente em nenhum lugar do seu aplicativo, site ou javascript.
{% endhint %}

## Utilizando HTTP Basic Auth

Para gerar o header de autenticação HTTP básico deve-se seguir os seguintes passos:

1. No HTTP Basic Auth, utiliza-se o formato é `login:senha` nosso login será `seu-api-token`, e como não utilizaremos uma senha, resulta em:\
   `seu-api-token:`
2. Codifique a string acima com Base64, e teremos o resuldado abaixo:\
   `c2V1LWFwaS10b2tlbg==`
3. Enviar essa informação no Header Authorization da request:\
   `Authorization: Basic c2V1LWFwaS10b2tlbg==`

```php
# exemplo com PHP
$AUTH_USER = 'seu-api-token';
$AUTH_PASS = '';

$ch = curl_init('https://api.peoplepass.com.br/context.action');
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_USERPWD, $AUTH_USER . ":" . $AUTH_PASS );
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
$return = curl_exec($ch);
curl_close($ch);
```