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

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

***

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

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

**Причины:**

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

**Решение:**

* Авторизуйтесь в **боте Telegram Mefree** ([@SuperXCoinBot](https://t.me/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 с такой структурой:

```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](https://mefree.net/api-docs).
* **Связь через Telegram**: напишите в чат [**@mefreenet**](https://t.me/mefreenet).

***

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