Час очікування запиту відстеження в реальному часі минув? Правила повторної спроби, резервного варіанта та статусів, яких слід дотримуватися
Коли запит на відстеження в реальному часі завершується через перевищення часу очікування, вважайте останній статус відправлення невідомим — не затриманим, не втраченим і не незмінним. Повторюйте запит лише в межах обмеженого часового бюджету, а потім показуйте чітко позначене останнє відоме оновлення або запропонуйте користувачеві перевірити ще раз пізніше. Протягом усього процесу розділяйте результат запиту, актуальність даних і фактичний статус посилки.
Це розрізнення важливе як для сторінок відстеження, орієнтованих на клієнтів, так і для систем, які використовують дані відстеження для запуску сповіщень або робочих процесів підтримки. Перевищення часу очікування означає, що відповідь не надійшла вчасно. Воно не повідомляє, чи має перевізник нову подію, чи обробила запит висхідна служба, або чи перемістилася посилка.
Спочатку визначте, де саме перевищено час очікування
Запит на відстеження може завершитися помилкою на кількох етапах: браузер може припинити очікування вашої програми, ваша програма може припинити очікування API відстеження, або це API може завершити очікування під час звернення до іншої служби. У кожному випадку користувач може бачити одну й ту саму загальну помилку, але відповідна наступна дія буде різною.
- Тайм-аут на стороні клієнта: Програма припинила очікування. Запит на стороні сервера все ще міг бути виконаний. Перевірте власні журнали запитів або сховище результатів, перш ніж надсилати інший запит, який може дублювати роботу.
- Помилка мережі або з’єднання: Ваша система не отримала придатної для використання відповіді. Ви можете не знати, чи обробила віддалена служба запит.
- HTTP 504: Шлюз або проксі не отримали своєчасної відповіді від висхідного сервера. Це описує шлях запиту, а не відправлення.
- HTTP 408: Сервер не отримав повного повідомлення запиту протягом часу, який він був готовий чекати. Це не статус відстеження перевізника.
- HTTP 200 зі старою подією: Запит виконано успішно, але повернена інформація про відстеження все ще може бути застарілою. Успішна відповідь HTTP не гарантує актуальності даних.
Записуйте ці результати як діагностичні дані запиту. Не перетворюйте жоден із них на позначення відправлення, як-от «у дорозі», «виняткова ситуація» або «доставлено». Такі позначення мають походити з подій відстеження або задокументованого поля статусу, а не з транспортного рівня.
Використовуйте обмежені повторні спроби, а не нескінченний цикл
Для пошуку даних відстеження лише для читання повторна спроба після перевищення часу очікування часто є виправданою. Проте її все одно слід обмежити. Повторні запити можуть збільшити навантаження на службу, яка працює нестабільно, продовжити очікування користувача та створити дубльовану роботу, коли кілька рівнів програми повторюють запит незалежно.
- Встановіть загальний крайній термін. Визначте, скільки часу може тривати операція для користувача, включно з першою спробою та повторною спробою. Не надавайте кожній спробі нового повного крайнього терміну, який перевищує час очікування виклику.
- Перевірте, чи безпечно повторювати операцію. Пошук зазвичай відрізняється від запиту, який реєструє відправлення, змінює налаштування або створює ресурс. Не відтворюйте автоматично запит, що змінює стан, якщо це не дозволено контрактом постачальника або вашими засобами ідемпотентності.
- Повторюйте тимчасову помилку помірно. Використовуйте невеликий, чітко визначений бюджет повторних спроб і затримку з випадковим розподілом, а не одночасні негайні повтори від багатьох клієнтів.
- Дотримуйтеся інструкцій сервера. Якщо відповідь містить дійсний заголовок
Retry-After, не плануйте повторну спробу раніше. Також дотримуйтеся суворішого обмеження програми або постачальника. - Зупиніться, коли крайній термін або бюджет вичерпано. Перейдіть до резервної відповіді та заплануйте окрему подальшу синхронізацію, якщо цього потребує ваш робочий процес.
Практична схема може передбачати одну повторну спробу для користувача, якщо залишилося достатньо часу, а подальші спроби перенести до фонового оновлення. Це приклад політики, а не універсальне правило API. Визначайте обмеження на основі цілей рівня обслуговування, фактичної затримки та документації постачальника. Також враховуйте повтори, виконані HTTP-бібліотеками, шлюзами та робочими процесами; інакше, на перший погляд, помірна політика програми може створити багато висхідних викликів.
Для HTTP 429 розглядайте відповідь як сигнал обмеження частоти, а не як причину для негайної повторної спроби. HTTP 503 може вказувати на тимчасову нездатність обробити запит, і сервер може надати Retry-After. HTTP 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 перед впровадженням.


