# Cabeçalhos e autenticação

Use o host e a credencial corretos e verifique o acesso com uma requisição gratuita.

Referência canônica: https://flashdata.dev/pt/docs/guides/headers-and-authentication
2026-11-04 por FlashData

<a id="requests"></a>

## Base URLs

| Propósito | Base URL | Autenticação |
| --- | --- | --- |
| Consultas de dados e trabalhos | https://data.flashdata.dev/v1 | X-API-Key |
| Identidade, equilíbrio, preços, limites e uso | https://api.flashdata.dev/v2 | X-API-Key |
| MCP | https://data.flashdata.dev/mcp | OAuth, ou X-API-Key |


<a id="choose"></a>

## Cabeçalhos de autenticação

Requisitos REST usam X-API-Key com uma chave de teste ou proprietário. Envie corpos JSON com Content-Type: application/json. Perfis CLI, ambientes SDK e conexões MCP armazenam credenciais separadamente.

### Chave REST / API

#### Requisito cabeçalhos

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

Deixe o anfitrião do MCP obter, armazenar e atualizar este token através do login. Use-o apenas no ponto final do MCP. Hospedeiros usando uma chave API em vez disso enviem X-API-Key.

#### Cabeçalho gerenciado pelo anfitrião MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Obtenha uma chave de API](https://flashdata.dev/pt/docs/guides/api-keys-and-permissions/reference.md)
- [Conecte-se através de MCP](https://flashdata.dev/pt/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## Verifique sua chave

Passe isso no seu terminal. A identidade verifica o acesso sem gastar créditos. Pule o prompt se o FLASHDATA_API_KEY já estiver pronto.

### Bash / cURL

Requer Bash e cURL 7.76+. Pule a chave secreta se seu ambiente já fornecer FLASHDATA_API_KEY. Execute os comandos de leitura no mesmo terminal.

#### Defina a tecla · skip se já configurado

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### Leia a conta JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

Pule o prompt de chave escondida se FLASHDATA_API_KEY já está definido. Execute os comandos de leitura no mesmo terminal.

#### Defina a tecla · skip se já configurado

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### Leia a conta JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="result"></a>

### Espera-se resposta

Espere HTTP 200. Verifique a conta pretendida, access: ready e sua fonte em escopos. Uma chave temporária tem accountType: temporary; o trabalho recorrente do proprietário requer recurringAllowed: true.

#### Identidade do proprietário. Excerto de resposta ilustrativa

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [Faça sua primeira chamada à API](https://flashdata.dev/pt/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## Armazenamento assinado URLs

Resultado e upload URLs incluem sua própria autorização. Siga o URL retornado sem X-API-Key, OAuth tokens ou cookies do navegador.


<a id="errors"></a>

## Autenticação de problemas

| Resposta | Próximo passo |
| --- | --- |
| 401 | Verifique a chave neste ambiente, sua expiração e revogação. Use uma chave API atual, não um símbolo MCP ou um prefixo do portador. |
| 403 / fonte faltando | Peça ao dono para dar a fonte necessária para esta chave. |
| 503 nesta leitura grátis | Tente ler mais tarde. O status da conta não foi verificado, não deduza que uma consulta paga está pronta. |

