Истёк срок ожидания запроса отслеживания в реальном времени? Правила повторной попытки, резервного переключения и статусов
Если время ожидания запроса на отслеживание в реальном времени истекло, рассматривайте последний статус отправления как неизвестный, а не как задержанный, утерянный или неизменившийся. Повторяйте запрос только в пределах ограниченного временного бюджета, затем показывайте четко обозначенное последнее известное обновление или предложите пользователю проверить информацию позже. На протяжении всего процесса разделяйте результат запроса, актуальность данных и фактический статус посылки.
Это различие важно как для страниц отслеживания, ориентированных на клиентов, так и для систем, использующих данные отслеживания для запуска уведомлений или рабочих процессов поддержки. Истечение времени ожидания означает, что ответ не поступил вовремя. Оно не сообщает, появилось ли у перевозчика новое событие, обработала ли запрос вышестоящая служба или переместилась ли посылка.
Сначала определите, где истекло время ожидания
Запрос на отслеживание может завершиться сбоем на нескольких этапах: браузер может прекратить ожидание ответа от вашего приложения, приложение может прекратить ожидание ответа от API отслеживания или API может завершить ожидание при обращении к другой службе. В каждом случае пользователь может увидеть одну и ту же общую ошибку, но подходящее следующее действие будет различаться.
- Тайм-аут на стороне клиента: приложение прекратило ожидание. Запрос на стороне сервера мог по-прежнему выполняться и завершиться успешно. Проверьте собственные журналы запросов или хранилище результатов, прежде чем отправлять новый запрос, который может привести к дублированию работы.
- Сбой сети или соединения: ваша система не получила пригодный для использования ответ. Возможно, вы не знаете, обработала ли удаленная служба запрос.
- HTTP 504: шлюз или прокси-сервер не получил своевременный ответ от вышестоящего сервера. Это описывает путь запроса, а не отправление.
- HTTP 408: сервер не получил полное сообщение запроса за отведенное время ожидания. Это не статус отслеживания перевозчика.
- HTTP 200 со старым событием: запрос выполнен успешно, но возвращенная информация об отслеживании все еще может быть устаревшей. Успешный ответ HTTP не гарантирует актуальность данных.
Фиксируйте эти результаты как диагностические данные запроса. Не переводите ни один из них в обозначения статуса отправления, такие как «в пути», «исключение» или «доставлено». Эти обозначения должны основываться на событиях отслеживания или документированном поле статуса, а не на транспортном уровне.
Используйте ограниченные повторные попытки, а не бесконечный цикл
Для запроса отслеживания только на чтение повторная попытка после истечения времени ожидания часто бывает разумной. Однако ее все равно следует ограничить. Повторные запросы могут увеличить нагрузку на испытывающую проблемы службу, продлить ожидание пользователя и создать дублирующую работу, если несколько уровней приложения независимо выполняют повторные попытки.
- Установите общий крайний срок. Определите, сколько времени может занимать операция, видимая пользователю, включая первоначальную попытку и любые повторные попытки. Не предоставляйте каждой попытке новый полный срок, превышающий время, которое вызывающая сторона может ждать.
- Проверьте, безопасно ли повторять операцию. Запрос обычно отличается от запроса, который регистрирует отправление, изменяет настройки или создает ресурс. Не воспроизводите автоматически запрос, изменяющий состояние, если безопасность этого не обеспечивается договором с поставщиком или средствами идемпотентности.
- Экономно повторяйте попытку при временном сбое. Используйте небольшой явно заданный бюджет повторных попыток и задержку со случайным разбросом вместо одновременной немедленной отправки повторных запросов от множества клиентов.
- Соблюдайте инструкции сервера. Если ответ содержит действительный заголовок
Retry-After, не планируйте повторную попытку раньше указанного времени. Также соблюдайте более строгие ограничения приложения или поставщика. - Остановитесь, когда срок или бюджет исчерпан. Переключитесь на резервный ответ и при необходимости отдельно запланируйте последующую сверку в фоновом режиме.
Практическая схема может разрешать одну повторную попытку, видимую пользователю, если остается достаточно времени, а дальнейшие попытки переносить в фоновое обновление. Это пример политики, а не универсальное правило API. Выбирайте ограничения на основе целей уровня обслуживания, наблюдаемой задержки и документации поставщика. Также учитывайте повторные попытки, выполняемые HTTP-библиотеками, шлюзами и рабочими процессами: иначе внешне умеренная политика приложения может привести к множеству вызовов вышестоящих служб.
Для HTTP 429 рассматривайте ответ как сигнал ограничения частоты запросов, а не как причину немедленно повторять запрос. HTTP 503 может указывать на временную невозможность обработать запрос, и сервер может предоставить Retry-After. Ошибка 504 может быть временной, но не гарантирует, что следующая попытка сработает. Ошибки аутентификации обычно требуют проверки учетных данных или разрешений, а некорректные запросы — исправления входных данных. Результат «не найдено» для идентификатора отслеживания требует большей осторожности: в зависимости от документированного поведения поставщика и этапа доставки может быть слишком рано искать запись или идентификатор может быть неверным. Не превращайте один такой результат в окончательное утверждение о том, что посылка не существует.
Выберите резервный вариант, сохраняющий известную информацию
Самым безопасным резервным вариантом обычно является последний подтвержденный результат отслеживания с указанием времени самого события и честной отметки актуальности. Отделяйте этот результат от текущего сбоя запроса. Страница может содержать текст: «Последнее доступное обновление: Отправление покинуло объект. Последняя проверка: [время]. Более новое обновление временно недоступно». Указывайте «Последняя проверка» только в том случае, если ваша система действительно записывает это время; оно не заменяет время события перевозчика.
Используйте наиболее точное время, которое можете подтвердить. Время события перевозчика указывает, когда, согласно сообщению, произошло событие. Время получения этого события вашей системой описывает прием данных. Время открытия страницы пользователем не описывает ни то, ни другое. Если источник не предоставляет надежное время события или часовой пояс, не выдумывайте их. Аналогично, если в кэшированном результате не записано время получения, называйте его «последним доступным обновлением», а не утверждайте, что оно недавно обновлялось.
Резервный вариант должен соблюдать три ограничения:
- Показывайте кэшированные данные как кэшированные данные. Не представляйте старое событие как результат запроса, время ожидания которого истекло.
- Не делайте вывод о продвижении по истекшему времени. Посылка не становится «переданной курьеру для доставки» только потому, что находится в пути несколько дней.
- Не скрывайте существенную неопределенность. Если предыдущего результата нет, сообщите, что отслеживание временно недоступно, вместо отображения вымышленного статуса по умолчанию.
Другие резервные варианты могут включать ранее синхронизированное хранилище отслеживания, авторизованный запрос к перевозчику или последующее фоновое обновление. Используйте их только в том случае, если они соответствуют отправлению, вашим разрешениям и условиям использования источника данных. У второго источника могут быть другие названия событий или задержки отчетности, поэтому сохраняйте происхождение данных и не объединяйте противоречивые записи без правила, определяющего порядок действий. Если клиент может предпринять действие на основе результата, предоставьте возможность повторить попытку или обратиться в поддержку, а не оставляйте индикатор загрузки на неопределенное время.
Разделяйте статус запроса, актуальность данных и статус отправления
Это три разных поля, даже если пользовательский интерфейс отображает их вместе. Статус запроса показывает, выполнен ли запрос успешно, истекло ли время ожидания или произошла ошибка. Актуальность данных показывает, когда возвращенная или сохраненная информация была получена. Статус отправления показывает, что источник отслеживания сообщает о посылке. Их разделение не позволяет временному сбою API перезаписать действительное событие доставки или превратить устаревшее событие «в пути» в утверждение о текущем статусе.
Например, система может хранить подтвержденное событие «Доставлено», полученное в ходе предыдущего запроса, в то время как текущее обновление завершается по тайм-ауту. Событие доставки не исчезает. Правильное совокупное состояние: последний доступный статус отправления — «доставлено», а последнее обновление завершилось сбоем. И наоборот, если последнее событие — «В пути», истечение времени ожидания не подтверждает, что посылка остается в пути в данный момент; оно подтверждает только то, что более новый ответ не был получен.
Применяйте определенное правило, когда события поступают не по порядку. Сравнивайте идентификаторы событий, временные метки, источник и документированную семантику статусов поставщика, если они доступны. Не предполагайте, что порядок получения обновлений вашей системой совпадает с порядком возникновения событий отправления. Поздно поступившее более старое событие также не должно автоматически заменять более новый подтвержденный статус. Однако исправления и исключения могут быть законными, поэтому избегайте универсального правила, считающего изменения статуса после доставки невозможными. Сохраняйте исходные события и исследуйте противоречия, а не переписывайте историю незаметно.
Если поставщик возвращает HTTP 202, интерпретируйте его согласно договору конкретной конечной точки: принятие запроса само по себе не означает завершенный запрос отслеживания. Аналогично, HTTP 200 подтверждает успешное выполнение HTTP-запроса в соответствии с семантикой этой конечной точки; это не доказывает наличие или актуальность каждого поля отслеживания. Сопоставляйте специфичные для поставщика поля ответа только после проверки документации поставщика.
Делайте сбой видимым для операторов, не тревожа клиентов
Полезная операционная запись включает идентификатор запроса, конечную точку или операцию, число попыток, прошедшее время, уровень тайм-аута, HTTP-статус, если он был получен, а также сведения о том, поступил ли ответ в результате актуального запроса или был использован резервный вариант. Для данных отслеживания записывайте источник и соответствующие временные метки события или получения данных. Обрабатывайте номера отслеживания и информацию о клиентах в соответствии с правилами вашей организации по доступу и хранению; диагностическая ценность не является основанием для раскрытия полных идентификаторов в общедоступных журналах.
Отслеживайте закономерности, а не полагайтесь на единичный тайм-аут. Рост частоты тайм-аутов на одном маршруте перевозчика, повторяющиеся ответы 429 или увеличивающийся разрыв между временем события перевозчика и временем получения могут указывать на разные проблемы. Первая может потребовать расследования со стороны поставщика, вторая — контроля частоты запросов, а третья — проверки синхронизации или доставки событий. Если приложение предоставляет отслеживание через такого поставщика, как 17TRACK Tracking API, перед реализацией этих общих правил используйте документацию поставщика для проверки полей ответа, ограничений запросов и обработки ошибок, специфичных для конечной точки.
В сообщении для клиента будьте точны и сдержанны: «Сейчас нам не удалось обновить информацию об отслеживании. Вот последнее доступное обновление». При необходимости укажите дальнейшее действие, например повторную проверку позже или обращение в поддержку, если отправление уже превысило ожидаемый срок доставки, установленный продавцом или перевозчиком. Не обещайте время обновления, которое ваша система не может гарантировать.
Контрольный список выпуска для процесса отслеживания, устойчивого к тайм-аутам
- Убедитесь, какой уровень устанавливает каждый тайм-аут и какой уровень отвечает за повторные попытки.
- Установите общий крайний срок запроса и отдельный ограниченный бюджет повторных попыток.
- Проверьте, безопасно ли автоматически повторять операции.
- Соблюдайте ограничения частоты запросов и действующие инструкции
Retry-After. - Храните результат запроса отдельно от статуса отправления и истории событий.
- Помечайте резервные данные и сохраняйте их источник и временные метки, если они доступны.
- Тестируйте сценарии без кэша, с устаревшим кэшем, 429, 503, 504 и поздним ответом.
- Проверьте, что тайм-аут не может вызвать неверное уведомление о доставке или стереть подтвержденное событие.
Основное правило просто: повторяйте запрос только тогда, когда это безопасно и полезно; используйте в качестве резерва только информацию, которую можете идентифицировать; и никогда не делайте вывод о статусе отправления на основании HTTP-тайм-аута.
Часто задаваемые вопросы
Следует ли немедленно повторить запрос отслеживания, время ожидания которого истекло?
Не автоматически. Проверьте, безопасно ли повторять операцию, остается ли в пределах общего крайнего срока время для еще одной попытки и не требует ли инструкция ограничения частоты запросов подождать. Короткая ограниченная повторная попытка со случайным разбросом может быть уместна для запроса только на чтение; многократные немедленные повторные попытки не должны быть вариантом по умолчанию.
Означает ли HTTP 504, что система отслеживания перевозчика не работает?
Нет. Это означает, что шлюз или прокси-сервер не получил своевременный ответ от вышестоящей службы. Проблема может находиться в любой точке этого пути запроса. Это не подтверждает ни общую доступность перевозчика, ни состояние посылки.
Можно ли показать последний известный статус после истечения времени ожидания?
Да, если обозначить его как последнюю доступную информацию, а не как результат успешного актуального обновления. Показывайте время события и время получения, если они известны, и четко указывайте, что более новое обновление подтвердить не удалось.
Должен ли тайм-аут изменить статус отправления с «в пути» на «исключение»?
Нет. Тайм-аут — это сбой запроса, а не событие отправления. Изменяйте статус отправления только тогда, когда надежный источник отслеживания предоставляет событие или статус, подтверждающий такое изменение.
Что делать, если запрос с истекшим временем ожидания создавал или регистрировал запись отслеживания?
Не предполагайте, что он завершился с ошибкой. Удаленная система могла обработать его до потери ответа. Проверьте наличие существующего результата и используйте документированный механизм идемпотентности или одобренную поставщиком процедуру восстановления, прежде чем отправлять запрос снова.
Источники
- RFC 9110, семантика HTTP — определения HTTP-статусов,
Retry-Afterи рекомендации по повторной отправке запросов. - RFC 6585, дополнительные коды состояния HTTP — определение HTTP 429 и его использование с
Retry-After. - Amazon Builders’ Library, «Тайм-ауты, повторные попытки и экспоненциальная задержка со случайным разбросом» — рекомендации по усилению повторных запросов, задержке и случайному разбросу.
- Документация 17TRACK Tracking API — справочная информация для проверки поведения API, специфичного для поставщика, перед реализацией.


