Как получить API-доступ?

API FatherSMM позволяет интегрировать заказы и проверку статусов в свои продукты — собственный SaaS, бот, мобильное приложение, агрегатор.

Кому доступен API

• Партнёрам с оборотом от 200 000 ₽/мес — стандартный API с лимитом 60 запросов/минуту.
• Партнёрам с оборотом от 2 000 000 ₽/мес — расширенный API без лимитов, доступ к webhook'ам, отдельная техподдержка.
• Корпоративным клиентам — кастомный API с SLA по запросу.

Что можно делать через API

• Создавать заказы (POST /orders).
• Проверять статусы (GET /orders/{id}).
• Запрашивать каталог услуг и тарифов (GET /services).
• Управлять балансом (POST /balance/topup).
• Получать список транзакций (GET /transactions).
• Подписываться на webhook-уведомления о статусах.

Как подключить

1. Войдите в личный кабинет → «Профиль» → «API».
2. Если у вас есть право доступа — будет кнопка «Сгенерировать ключ».
3. Сгенерируйте ключ — он показывается ОДИН раз, скопируйте и сохраните в надёжное место.
4. Используйте ключ в заголовке Authorization: Bearer {KEY} для всех запросов.

Документация

Полная спецификация — на docs.fathersmm.com/api. Там примеры запросов на cURL, Python, JS, готовые SDK для Node.js и PHP.

Webhook'и

Можно настроить автоматическое уведомление вашего сервера о смене статуса заказа. Поддерживаемые события:

• order.created — заказ создан.
• order.started — заказ перешёл в работу.
• order.completed — заказ выполнен.
• order.partial — заказ закрыт со статусом частичного выполнения.
• order.failed — сбой, нужна реакция.

Webhook отправляется HTTP POST с JSON-телом и подписью HMAC-SHA256 в заголовке.

Безопасность

• Никогда не публикуйте API-ключ в открытом коде (frontend, репозиторий).
• Используйте HTTPS для всех запросов.
• При компрометации ключа — отзовите его в личном кабинете и сгенерируйте новый.
• Включите 2FA на аккаунте — это требование для работы API при выводе средств.

Ограничения

• Скорость — 60 запросов/минуту для стандартного, без лимитов для расширенного.
• При превышении — 429 Too Many Requests и временная блокировка ключа на 5 минут.
• Создание заказов суммой выше 50 000 ₽ за один запрос требует дополнительного подтверждения через 2FA.