Skip to main content
НачалоБлогРъководстваЗаявката за проследяване в реално време изтече? Правила за повторен опит, резервен вариант и статус, които трябва да се следват

Заявката за проследяване в реално време изтече? Правила за повторен опит, резервен вариант и статус, които трябва да се следват

17TRACK

Когато заявка за проследяване в реално време изтече, приемете, че последният статус на пратката е неизвестен — не забавен, изгубен или непроменен. Повторете опита само в рамките на ограничен времеви бюджет, след което покажете ясно обозначена последна известна актуализация или помолете потребителя да провери отново по-късно. През целия процес поддържайте отделно резултата от заявката, актуалността на данните и действителния статус на пратката.

Заявката за проследяване в реално време изтече: повторен опит, резервен вариант и статус

Това разграничение е важно както за страниците за проследяване, предназначени за клиентите, така и за системите, които използват данни за проследяване, за да задействат известия или работни процеси за поддръжка. Изтичането на времето означава, че отговорът не е пристигнал навреме. То не показва дали превозвачът има ново събитие, дали услуга нагоре по веригата е обработила заявката или дали пратката се е придвижила.

Първо установете какво е изтекло

Заявка за проследяване може да се провали на няколко етапа: браузърът може да спре да чака приложението ви, приложението ви може да спре да чака API за проследяване или това API може да изтече, докато се свързва с друга услуга. Потребителят може да види една и съща обща грешка във всеки от тези случаи, но подходящото следващо действие е различно.

  • Изтичане на времето от страна на клиента: Приложението е спряло да чака. Заявката от страна на сървъра може все още да е завършила. Проверете собствените си регистрационни файлове за заявки или хранилището с резултати, преди да изпратите друга заявка, която може да дублира работата.
  • Мрежова или комуникационна грешка: Системата ви не е получила използваем отговор. Възможно е да не знаете дали отдалечената услуга е обработила заявката.
  • HTTP 504: Шлюз или прокси не е получило навременен отговор от сървър нагоре по веригата. Това описва пътя на заявката, а не пратката.
  • HTTP 408: Сървърът не е получил пълно съобщение със заявката в рамките на времето, през което е бил подготвен да чака. Това не е статус за проследяване от превозвача.
  • HTTP 200 със старо събитие: Заявката е успешна, но върнатата информация за проследяване може все още да е остаряла. Успешният HTTP отговор не гарантира актуалност.

Записвайте тези резултати като диагностични данни за заявката. Не превръщайте нито един от тях в етикети за пратката като „в движение“, „изключение“ или „доставена“. Тези етикети трябва да идват от събитията за проследяване или от документирано поле за статус, а не от транспортния слой.

Използвайте ограничен повторен опит, а не безкраен цикъл

При справка за проследяване само за четене повторен опит след изтичане на времето често е разумен. Той все пак трябва да бъде ограничен. Повтарящите се заявки могат да увеличат натоварването върху затруднена услуга, да удължат чакането на потребителя и да създадат дублирана работа, когато няколко слоя на приложението извършват повторни опити независимо един от друг.

  1. Задайте общ краен срок. Определете колко дълго може да продължи операцията, видима за потребителя, включително първоначалния опит и всеки повторен опит. Не задавайте на всеки опит нов пълен краен срок, който надхвърля времето, през което извикващата страна може да чака.
  2. Проверете дали операцията е безопасна за повторение. Справката обикновено се различава от заявка, която регистрира пратка, променя настройки или създава ресурс. Не изпращайте автоматично повторно заявка, променяща състоянието, освен ако договорът с доставчика или вашите механизми за идемпотентност не правят това безопасно.
  3. Повтаряйте опита при преходна грешка пестеливо. Използвайте малък, изрично определен бюджет за повторни опити и забавяне с произволно отклонение, вместо да изпращате едновременни незабавни повторни опити от много клиенти.
  4. Спазвайте приложимите инструкции на сървъра. Ако отговорът включва валиден хедър Retry-After, не планирайте по-ранен повторен опит. Спазвайте и всяко по-строго ограничение на приложението или доставчика.
  5. Спрете, когато крайният срок или бюджетът бъдат изчерпани. Преминете към резервен отговор и планирайте отделно последващо съгласуване, ако работният ви процес го изисква.

Практическият дизайн може да позволява един повторен опит, видим за потребителя, ако остава достатъчно време, като последващите опити бъдат преместени към фоново обновяване. Това е пример за политика, а не универсално правило за 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, че системата за проследяване на превозвача не работи?

Не. Това означава, че шлюз или прокси не е получило навременен отговор от сървър нагоре по веригата. Проблемът може да е навсякъде по този път на заявката. Това не установява общата достъпност на превозвача или състоянието на пратката.

Мога ли да покажа последния известен статус след изтичане на времето?

Да, ако го обозначите като последната налична информация, а не като успешно актуално обновяване. Показвайте времето на събитието и времето на извличане, когато са известни, и пояснявайте, че по-нова актуализация не е могла да бъде потвърдена.

Трябва ли изтичането на времето да промени пратката от „в движение“ на „изключение“?

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

Какво да направя, ако заявката, чието време е изтекло, е създавала или регистрирала запис за проследяване?

Не приемайте, че е неуспешна. Отдалечената система може да я е обработила, преди отговорът да бъде изгубен. Проверете за съществуващ резултат и използвайте документиран механизъм за идемпотентност или одобрена от доставчика процедура за възстановяване, преди да я изпратите отново.

Източници