Начинайте интеграцию с актуальной страницы API THEPANEL. Она определяет endpoint, действия, обязательные поля и примеры ответов. Старый запрос из другого проекта может не соответствовать текущим типам услуг.
Разделяйте ID
ID услуги выбирает элемент каталога. ID заказа относится к уже принятому запросу. Храните оба вместе со своей внутренней ссылкой, объектом, количеством и результатом отправки.
Обновляйте сведения каталога
Проверяйте доступность, цену, тип и диапазон количества до приёма заказа клиента. Кэш нельзя считать актуальным бессрочно. Для разных типов услуг могут требоваться разные поля.
Защищайте ключ
Храните API-ключ на сервере или в подходящем хранилище секретов. Не помещайте его в публичный JavaScript, таблицы, снимки экрана и отчёты об ошибках. В примерах используйте обозначения вместо реальных секретов.
Тайм-аут не доказывает отказ
Запрос мог быть принят до разрыва ответа. Перед повтором создания заказа проверьте сохранённые результаты и историю панели. Не предполагайте поддержку идемпотентности, если её нет в документации. Для неопределённого результата предусмотрите сверку вместо слепого повтора.
Проверьте жизненный цикл
- Валидация полей и количества.
- Сохранение ID и ошибок.
- Обработка частичного выполнения и отмены.
- Только документированные действия refill/cancel.
- Соблюдение ограничений и разумный опрос статуса.
Эта статья не выполняет API-запросов и не меняет ваши ключи.

