Часто задаваемые вопросы и решения (FAQ)

Ниже представлены распространенные проблемы при использовании API Mefree.NET и рекомендации по их решению, чтобы помочь вам быстро разобраться с возникшими трудностями.

---

1. Проблемы с аккаунтом и правами доступа

1.1 Почему мой API-ключ не работает?

Причины:

• API-ключ мог быть отключён или удалён.

Решение:

• Авторизуйтесь в боте Telegram Mefree (@SuperXCoinBot) и проверьте статус вашего API-ключа в личном кабинете.

---

1.2 Как настроить доступ к API-ключу только с определённых IP-адресов?

Решение:

• При создании или редактировании API-ключа укажите IP-адреса, с которых разрешены запросы.

• После настройки API-ключ будет принимать запросы только с указанных IP-адресов, что повышает безопасность.

---

2. Проблемы с подписью и аутентификацией

2.1 Почему возвращается ошибка 401 Unauthorized?

Причины:

• Неправильные MF-ACCESS-KEY или MF-ACCESS-SIGN.

• Ошибки при генерации подписи.

• Разница между вашим временем и временем сервера превышает 5 секунд.

Решение:

1. Проверьте, совпадает ли MF-ACCESS-KEY с вашим API-ключом.

2. Убедитесь, что подпись сгенерирована в соответствии с правилами подписи.

3. Используйте UTC-время и убедитесь, что разница с серверным временем не превышает 5 секунд.

---

2.2 Как проверить корректность подписи?

Решение:

1. Выведите строку для подписи (формат: timestamp + method + requestPath).

2. Сравните сгенерированную подпись с локально вычисленной.

3. Используйте инструменты (например, Postman или Curl) для ручного тестирования подписи.

---

3. Проблемы с запросами и ответами

3.1 Почему возвращается ошибка 400 Bad Request?

Причины:

• Ошибки в параметрах запроса (например, отсутствует обязательное поле или неверный формат данных).

• Неправильный путь к API.

Решение:

• Проверьте документацию API и убедитесь, что все параметры запроса указаны верно.

• Убедитесь, что заголовок Content-Type установлен как application/json.

• Проверьте, правильно ли отформатирован JSON в теле запроса.

---

3.2 Почему возвращается ошибка 429 Too Many Requests?

Причины:

• Частота запросов превышает лимит API.

Решение:

• Ознакомьтесь с документацией API, чтобы узнать лимиты запросов.

• Реализуйте в коде ограничение скорости (например, не превышать количество запросов в секунду).

• Если вы используете распределённую систему, убедитесь, что общая частота запросов не превышает допустимый лимит.

---

3.3 Почему возвращается ошибка 500 Internal Server Error?

Причины:

• На сервере API могут возникать временные проблемы.

Решение:

1. Проверьте соединение с сетью, чтобы убедиться, что запрос отправлен корректно.

2. Повторите запрос через несколько секунд.

3. Если проблема сохраняется, обратитесь в техническую поддержку Mefree.

---

4. Проблемы с конкретными методами API

4.1 Почему невозможно создать заказ?

Причины:

• Недостаточно средств на счёте.

• Ошибки в параметрах заказа (например, неверное количество или срок).

• Аккаунт не имеет права создавать заказы.

Решение:

1. Проверьте, хватает ли средств на вашем счёте.

2. Убедитесь, что параметры заказа соответствуют требованиям, указанным в документации.

3. Убедитесь, что у аккаунта есть права на размещение заказов.

---

5. Проблемы с разработкой и отладкой

5.1 Как справиться с тайм-аутами?

Причины:

• Слабое соединение с интернетом или нестабильная сеть.

Решение:

1. Установите более длительное время ожидания для запросов (например, timeout=30).

2. Для критически важных операций настройте повторные попытки (например, 2-3 раза).

3. Проверьте соединение между вашим сервером и API Mefree.

---

5.2 Как обрабатывать ответы API?

Решение:

• Ответы API Mefree обычно представлены в формате JSON с такой структурой:

{
  "code": "0",
  "msg": "",
  "data": {
    "key": "value"
  }
}

• Описание полей:

  • code: Код ответа, 0 — успешный запрос, любое другое значение — ошибка.

  • msg: Описание ошибки (только при ошибке).

  • data: Основная информация (например, детали заказа или баланс).

---

6. Прочие проблемы

6.1 Почему возникают ошибки с временной меткой?

Причины:

• Локальное время отличается от серверного UTC.

Решение:

• Используйте метод datetime.utcnow() в Python для получения UTC-времени.

---

6.2 Как справляться с обновлениями API?

Решение:

1. Подпишитесь на объявления для разработчиков Mefree, чтобы быть в курсе изменений API.

2. Регулярно обновляйте ваш код, чтобы соответствовать новой версии API.

3. Используйте версионирование API (например, /v1/), чтобы избежать проблем с совместимостью при обновлениях.

---

7. Техническая поддержка

Если вы не можете самостоятельно решить проблему, воспользуйтесь одним из следующих способов для связи с техподдержкой Mefree:

• Подать заявку: через центр поддержки Mefree.

• Документация для разработчиков: официальная документация API.

• Связь через Telegram: напишите в чат @mefreenet.

---

Надеемся, что этот FAQ поможет вам быстро разобраться с проблемами при использовании API Mefree.NET. Если у вас возникнут дополнительные вопросы, не стесняйтесь обращаться в поддержку или задавать их здесь!