Анализ журналов запросов solvethree при сбое интеграции

Автор: solvethree3 мин на чтение

Начните с ID задачи или requestId проблемной попытки. Найдите соответствующий запрос в консоли, затем сравните его с HTTP-ответом и статусом задачи, записанными вашей интеграцией.

На этой странице

Найдите проблемную попытку

  1. 1.

    Откройте журналы запросов

    В консоли откройте /request-logs. Поле поиска обозначено текстом-подсказкой: «ID запроса, сайт, действие или ошибка». Найдите записанный вами идентификатор задачи или запроса; используйте сайт или действие для поиска связанных попыток.

  2. 2.

    Начните с фильтра «Все»

    Пока ищете запрос, оставьте выбранным фильтр «Все». Затем сузьте результаты с помощью фильтров «Успешные», «Неудачные», «В очереди» или «Отклонённые». Если начать с более узкого фильтра, нужная попытка может оказаться скрыта.

  3. 3.

    Сопоставьте время

    В таблице есть столбцы «ID запроса», «Сайт», «Действие», «Тарификация», «Задержка», «Время» и «Результат». Сопоставьте время, сайт и действие с записями вашего приложения, чтобы не исследовать другую попытку на том же целевом сайте.

Сравните задержки в соответствующих строках, чтобы выявить более медленные попытки. Сопоставляйте их с длительностью HTTP-запросов вашего приложения; не считайте, что одно значение в консоли объясняет всю задержку, наблюдаемую клиентом.

Кнопка «Экспорт CSV» экспортирует отфильтрованные строки. Перед экспортом настройте поиск и фильтры на нужные попытки, а затем проверьте файл, прежде чем делиться им.

Различайте HTTP-ошибки, сбои задач и отклонения целевым сайтом

Фильтры консоли описывают результаты запросов и решений на стороне сервиса. Статус «Успешно» не подтверждает, что целевой сайт принял ваш токен. Чтобы определить, на каком этапе произошёл сбой, используйте HTTP-ответ и данные задачи.

API вернул HTTP-статус, не обозначающий успех.

Изучите статус и ответ с ошибкой, записанные вашим клиентом. Не воспринимайте их как данные успешно выполненной задачи.

Попробуйте: Сначала обработайте HTTP-ошибку и устраните указанную проблему, прежде чем повторять попытку. Не считайте, что любой сбой означает нехватку средств. См. обработку ошибок API.

Задача ожидает выполнения или решается.

Это промежуточные статусы задачи, а не готовые к использованию решения.

Попробуйте: Продолжайте опрашивать эту задачу, пока она не будет готова или не завершится с ошибкой. Не создавайте замену только потому, что решение пока недоступно.

Задача завершилась с ошибкой.

Изучите и errorCode, и error. Например, site-unreachable — код ошибки задачи.

Попробуйте: Прекратите опрос этой задачи и устраните указанную причину перед следующей попыткой. За неудачные решения средства возвращаются; повторная отправка тех же некорректных входных данных их не исправит.

Время ожидания создания задачи истекло, и вы не знаете, была ли она создана.

Сохраните ID задачи, если он есть, и requestId, использованный для попытки. Тайм-аут соединения не доказывает, что задача не была создана.

Попробуйте: Получите задачу, если у вас есть её ID. В противном случае, если вы передали requestId, повторно отправьте тот же запрос задачи с этим ID, чтобы восстановить существующую задачу. Не используйте его повторно с изменёнными входными данными: это вызовет конфликт.

Задача готова, но сайт отклоняет отправленные данные.

Проверьте исходящий запрос к сайту. Убедитесь, что он содержит solution.token, а не ID задачи или старый токен.

Попробуйте: Используйте возвращённые userAgent и secChUa вместе с успешным прокси и нужным целевым сайтом. Не смешивайте параметры идентификации и не меняйте прокси между решением и отправкой. Один лишь HTTP 403 от целевого сайта не позволяет определить, какая защита отклонила запрос.

Отправляйте поддержке идентификаторы, а не секреты

Если причина по-прежнему неясна, напишите на [email protected] и предоставьте достаточно информации, чтобы найти попытку и отличить сбой сервиса от отклонения отправленных данных сайтом.

  • ID задачи и/или requestId, продукт и время с указанием часового пояса.
  • HTTP-статус API либо errorCode и error задачи, достигшей конечного состояния.
  • Имя хоста целевого сайта и действие.
  • Описание ответа без конфиденциальных данных с указанием, получен ли он от solvethree или от целевого сайта.
  • Подходящие отфильтрованные строки журнала, если они полезны, проверенные и очищенные от конфиденциальных данных перед отправкой.

Удалите API-ключи, пароли прокси, токены, cookie и данные клиентов из отчёта и всех вложений. Поддержке достаточно ID задач и запросов и временных меток без конфиденциальных данных; сам токен не нужен для поиска попытки.

Проблема не решена?

Отправьте в поддержку ID задачи и полученную ошибку.

Связаться с поддержкой
Анализ журналов запросов solvethree при сбое интеграции · solvethree