Отделить конфигурацию от кода
Храните адрес API и учётные данные вне исходного кода. Используйте переменные окружения на сервере и никогда не включайте настоящий ключ в код, отправляемый браузеру. Демонстрационная интеграция в этой версии использует только примеры данных.
Определите контракт перед подключением
Согласуйте с командой API поля задач, возможные статусы и форматы ошибок. Общее описание интерфейса сокращает повторную работу и исключает неявные договорённости между панелью и сервисом.
Планирование жизненного цикла запроса
Задайте тайм-ауты для создания задач и получения результатов. При асинхронной обработке опрашивайте сервис с заданным интервалом и ограничением числа попыток. По истечении срока приложение должно явно прекращать ожидание.
Относитесь к ошибкам как к части продукта.
Неверные учётные данные, недостаточный баланс и недоступность сервиса требуют отдельных ответов. Показывайте понятные сообщения и записывайте только необходимую для диагностики информацию, без учётных данных и токенов решения.
Проверьте перед выпуском
Проверяйте ошибки аутентификации, ограничения использования и неожиданные ответы в тестовой среде. Эта документация предлагает структуру конечных точек API; реальный сервис будет подключён после согласования интерфейса.
Изучите свой следующий рабочий процесс.
Откройте для себя демонстрационную панель управления.
Открыть панель управления
