# Índice

1. [Quando usar o endpoint de autenticações Gov.br](#quando-usar)
2. [Enviando uma requisição](#criacao-pedido)
3. [Parâmetros de configuração](#parametros-configuracao)
4. [Estrutura da resposta](#estrutura-de-resposta)
5. [Exemplo de requisição](#exemplo-requisicao)

## [Quando usar o endpoint de autenticações Gov.br](#quando-usar)
Esse endpoint retorna informações sobre as autenticações em duas etapas cadastradas no Gov.br, na sua conta da Infosimples.

> Este endpoint não tem custo.

> Você pode realizar até 100 consultas por hora.


## [Enviando uma requisição](#criacao-pedido)
|                    |                                                          |
| ------------------ | -------------------------------------------------------- |
| Método HTTP        | GET ou POST                                              |
| URL                | https://api.infosimples.com/api/admin/autenticacao-govbr |
| Formato do retorno | JSON                                                     |


## [Parâmetros de configuração](#parametros-configuracao)
`*`: Parâmetro obrigatório
| Parâmetro | Descrição                                                                                                |
| --------- | -------------------------------------------------------------------------------------------------------- |
| token*    | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. |


## [Estrutura da resposta](#estrutura-de-resposta)
Uma resposta do endpoint de autenticações Gov.br possui, dentro da chave <code>data</code>, um array com os seguintes campos para cada sessão:
| Campo      | Tipo    | Descrição                                                                                                                         |
| ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| type       | string  | Tipo de login utilizado. Valores possíveis: <code>CPF/Senha</code> ou <code>Certificado A1</code>.                                |
| identifier | string  | Identificador do login mascarado para proteção de dados sensíveis. Exemplo: <code>***123456**</code>.                             |
| expired    | boolean | Indica se a autenticação já expirou (<code>true</code>) ou ainda está ativa (<code>false</code>).                                 |
| created_at | string  | Data e hora de criação da sessão MFA no formato <code>dd/mm/aaaa hh:mm</code>.                                                    |
| expires_at | string  | Data e hora prevista de expiração da sessão MFA no formato <code>dd/mm/aaaa hh:mm</code>.                                         |
| expired_at | string  | Data e hora em que a sessão MFA expirou no formato <code>dd/mm/aaaa hh:mm</code>. Retorna <code>null</code> se ainda não expirou. |


## [Exemplo de requisição](#exemplo-requisicao)

#### Python
```python
# Testado com: Python 3.10.19, Python 3.14.0
import requests

url = "https://api.infosimples.com/api/admin/autenticacao-govbr"
args = {
  "token": "VALOR_DO_PARAMETRO_TOKEN"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

print(response_json)
```


### Exemplo de resposta

#### Sucesso
```json
{
    "code": 200,
    "code_message": "A requisição foi processada com sucesso.",
    "data": [
        {
            "type": "CPF/Senha",
            "identifier": "***123456**",
            "expired": false,
            "created_at": "12/02/2026 08:15",
            "expires_at": "15/03/2026 10:30",
            "expired_at": null
        },
        {
            "type": "Certificado A1",
            "identifier": "***654321**",
            "expired": true,
            "created_at": "10/02/2026 12:45",
            "expires_at": "15/02/2026 14:00",
            "expired_at": "15/02/2026 14:00"
        }
    ]
}
```


#### Erro
```json
{
    "code": 601,
    "code_message": "Não foi possível se autenticar com o token informado.",
    "errors": [
        "Você não tem permissão para acessar este recurso."
    ]
}
```



## Precisa de ajuda?
Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.