> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/wings/especificacoes-tecnicas.md).

# Especificações técnicas

**A API utiliza os seguintes padrões:**&#x20;

* **Protocolo**: HTTP.&#x20;
* **Formato de dados:** JSON.&#x20;
* **Autorização**: tokens de acesso do tipo Bearer nas operações protegidas.&#x20;
* **Autenticação**: fluxos distintos para usuários e aplicações externas.&#x20;

**Paginação e consultas**&#x20;

As consultas de usuários corporativos permitem paginação, pesquisa e aplicação de filtros.&#x20;

Na consulta de usuários de varejo por corporação, são utilizados os seguintes parâmetros:&#x20;

| **Parâmetro**            | **Valor**     |
| ------------------------ | ------------- |
| Página padrão            | 1             |
| Tamanho padrão da página | 25 registros  |
| Tamanho máximo da página | 500 registros |

**Status de usuários**&#x20;

Os filtros e as operações de atualização em lote reconhecem os seguintes estados:&#x20;

* Habilitado.&#x20;
* Bloqueado.&#x20;
* Removido.&#x20;

A consulta também disponibiliza um estado combinado para usuários bloqueados e removidos.&#x20;

**Ambientes**

Homologação: [https://billing.hom.vaultid.com.br](https://billing.hom.vaultid.com.br/)&#x20;

Produção: [https://billing.vaultid.com.br](https://billing.vaultid.com.br/)
