Autenticação

Cada request para a API FourA exige autenticação. Esta página explica como obter, usar e gerenciar sua chave de API.

Como obter sua chave de API

1. Faça login no FourA Dashboard
2. Acesse a página API Keys
3. Clique em Create Key
4. Copie a chave imediatamente (ela não será exibida novamente por completo)

Sua chave de API se parece com isto: pk_live_a1b2c3d4e5f6...

Como Usar sua Chave de API

Inclua sua chave de API no header X-API-Key de cada request:

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'

Em Python:

import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)

Em Node.js:

const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});

Segurança da Chave de API

Trate sua chave de API como uma senha:

• Não a envie para o controle de versão. Em vez disso, use variáveis de ambiente.
• Não a exponha em código do lado do cliente. Use-a apenas em aplicações do lado do servidor.
• Faça a rotação se for comprometida. Crie uma nova chave a partir do Dashboard e desative a antiga.

Usando Variáveis de Ambiente

Armazene sua chave em uma variável de ambiente:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

Depois, faça referência a ela em seu código:

import os
api_key = os.environ["FOURA_API_KEY"]

const apiKey = process.env.FOURA_API_KEY;

Erros Comuns de Autenticação

Todas as falhas de autenticação retornam um status 401 Unauthorized.

Próximos Passos

• Quick Start: Faça seu primeiro request
• API Endpoints: Referência completa de endpoints
• Error Handling: Trate erros de autenticação de forma adequada