# Autenticação e chaves de API

Entenda X-API-Key, autenticação RapidAPI, sessões do portal e boas práticas para proteger credenciais da IaBula.

Canonical: https://iabula.com/docs/authentication

## Acesso direto: X-API-Key

Envie a chave no cabeçalho X-API-Key de cada requisição /v1. O portal permite criar e revogar chaves da sua conta, sujeito aos controles de confirmação de identidade existentes. O segredo é exibido uma única vez na criação; a listagem posterior contém identificadores e status.

```bash
curl --fail-with-body --get "$IABULA_API_BASE/v1/medications/search" \
  --header "X-API-Key: $IABULA_API_KEY" \
  --data-urlencode 'q=dipirona' \
  --data-urlencode 'limit=20'
```

- [Gerenciar chaves](https://iabula.com/account#account-api-keys)

## Acesso pelo marketplace

Chamadas feitas pelo Hub RapidAPI usam as credenciais e os cabeçalhos apresentados pelo próprio marketplace. Não use a chave direta da IaBula como chave RapidAPI e não envie secrets internos de gateway. Use o snippet de integração gerado pelo listing para seu plano.

- [Guia RapidAPI](https://iabula.com/docs/rapidapi)

## Sessão web e consumo da API

Login mantém sua sessão no portal. A API REST tem autenticação própria; um cookie de sessão não substitui uma chave. Consulte plano, limites e consumo da conta antes de dimensionar sua integração. Os limites dependem do canal e do plano, portanto esta documentação não fixa uma quota universal.

## Proteja suas credenciais

- Use HTTPS e mantenha a chave no servidor.
- Não inclua chaves em URLs, logs, screenshots, commits ou JavaScript público.
- Se houver exposição, revogue a chave e atualize sua integração.
- Nunca compartilhe secrets de infraestrutura ou tente autenticar pelo gateway interno.

- [Respostas 401, 403 e 429](https://iabula.com/docs/errors)

## Recursos

- [OpenAPI JSON](https://iabula.com/openapi.json)
- [Swagger](https://iabula.com/docs/swagger)
- [Documentation index](https://iabula.com/llms.txt)