Перейти к основному содержанию

API‑ключи

Все эндпоинты v1 требуют API‑ключ в заголовке x-api-key.

Создание API‑ключей

  1. Войдите в панель AFKCrypto
  2. Перейдите в раздел API Keys
  3. Нажмите «Generate API Key»
  4. Задайте ключу понятное имя
  5. Необязательно: установите срок действия (7 дней, 30 дней, 90 дней, 180 дней или 1 год)
  6. Сразу скопируйте ключ — повторно он не показывается

Формат ключа

afk_<prefix>_<random>

Пример: afk_xY3z_Ab12cD34Ef56Gh78Ij90Kl12Mn34Op56
  • Prefix: 4‑символьный идентификатор для быстрого поиска
  • Random: криптографически стойкая 32‑символьная случайная строка

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

Передавайте ключ в каждом запросе через заголовок x-api-key:
curl -X GET https://api.afkcrypto.com/api/v1/wallets \
  -H "x-api-key: afk_xY3z_Ab12cD34Ef56Gh78Ij90Kl12Mn34Op56"

Рекомендации по безопасности

  • Никогда не коммитьте ключи — используйте переменные окружения
  • Регулярно ротируйте ключи — задавайте срок действия для временного доступа
  • Разделяйте ключи по средам — dev, staging, production
  • Немедленно отзывайте неиспользуемые ключи — снижайте поверхность атаки
  • Храните безопасно — менеджер секретов (например, AWS Secrets Manager, HashiCorp Vault)

Срок действия ключа

API‑ключи могут истекать по истечении заданного периода:
  • Без срока (по умолчанию): действует до отзыва
  • 7 дней: кратковременные тесты/демо
  • 30 дней: доступ для подрядчиков или испытаний
  • 90 дней: рекомендованная квартальная ротация
  • 180 дней: полугодовая ротация
  • 1 год: ежегодная ротация для стабильных интеграций
Что происходит при истечении срока?
  • Запросы с таким ключом возвращают HTTP 401 UNAUTHORIZED
  • Ключ остаётся видимым в панели для аудита
  • Создайте новый ключ для замены
Мониторинг срока
  • В панели отображаются статусы «Expired» или «Expiring soon» (≤ 7 дней)
  • Настройте оповещения, чтобы избежать перебоев

Лимиты ключей

  • Максимум активных ключей: 10 на пользователя
  • Действуют лимиты запросов: см. Rate limiting
  • Отзывайте неиспользуемые ключи, чтобы оставаться в лимите

Отзыв API‑ключей

Отзовите ключ немедленно через панель:
  1. Откройте API Keys
  2. Найдите нужный ключ
  3. Нажмите «Revoke Key»
  4. Подтвердите действие
Примечание: отзыв необратим и вступает в силу сразу.

Ссылки