Автентикация

Всяка request към FourA API изисква автентикация. Тази страница обяснява как да получите, използвате и управлявате вашия API key.

Получаване на вашия API key

1. Влезте в FourA Dashboard
2. Отидете на страницата API Keys
3. Кликнете върху Create Key
4. Копирайте вашия API key незабавно (той няма да бъде показан отново изцяло)

Вашият API key изглежда така: pk_live_a1b2c3d4e5f6...

Използване на вашия API key

Включете вашия API key в X-API-Key header на всяка 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 key

Третирайте вашия API key като парола:

• Не го добавяйте в системата за контрол на версиите. Използвайте променливи на средата вместо това.
• Не го излагайте в клиентски код. Използвайте го само в приложения от страната на сървъра.
• Ротирирайте го при компрометиране. Създайте нов API key от Dashboard и деактивирайте стария.

Използване на променливи на средата

Съхранявайте вашия API key в променлива на средата:

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: Пълен endpoint справочник
• Справяне с грешки: Справяйте се елегантно с грешките при автентикация