Аутентификация

Каждый request к FourA API требует аутентификации. Эта страница объясняет, как получить, использовать и управлять вашим API-ключом.

Получение API-ключа

1. Войдите в FourA Dashboard
2. Перейдите на страницу API Keys
3. Нажмите Create Key
4. Сразу скопируйте ключ (он не будет показан снова полностью)

Ваш API-ключ выглядит так: pk_live_a1b2c3d4e5f6...

Использование API-ключа

Передавайте ваш API-ключ в header X-API-Key каждого 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"}'

В 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"}
)

В 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' })
});

Безопасность API-ключа

Относитесь к вашему API-ключу как к паролю:

• Не отправляйте его в систему контроля версий. Вместо этого используйте переменные окружения.
• Не раскрывайте его в клиентском коде. Используйте его только в серверных приложениях.
• Выполните ротацию в случае компрометации. Создайте новый ключ в Dashboard и деактивируйте старый.

Использование переменных окружения

Сохраните ваш ключ в переменной окружения:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

Затем используйте его в коде:

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

const apiKey = process.env.FOURA_API_KEY;

Распространенные ошибки аутентификации

Все ошибки аутентификации возвращают статус 401 Unauthorized.

Следующие шаги

• Быстрый старт: Выполните свой первый request
• API Endpoints: Полный справочник по endpoints
• Обработка ошибок: Корректно обрабатывайте ошибки аутентификации