Skip to main content
ДомаБлогВодичиИстече времето на барањето за следење во реално време? Следете ги правилата за повторен обид, резервна опција и статус

Истече времето на барањето за следење во реално време? Следете ги правилата за повторен обид, резервна опција и статус

17TRACK

Кога барањето за следење во реално време ќе истече, третирајте го најновиот статус на пратката како непознат — не како доцнење, изгубена или непроменета пратка. Повторете го обидот само во рамки на ограничен временски буџет, а потоа прикажете јасно означено последно познато ажурирање или побарајте од корисникот да провери повторно подоцна. Во текот на целиот процес одделно чувајте го исходот од барањето, свежината на податоците и реалниот статус на пакетот.

Real Time Tracking Request Timed Out Retry Fallback and Status

Ова разграничување е важно и за страниците за следење наменети за корисници и за системите што ги користат податоците за следење за активирање известувања или работни текови за поддршка. Истекувањето на времето ви кажува дека одговорот не пристигнал навреме. Не ви кажува дали превозникот има нов настан, дали надворешната услуга го обработила барањето или дали пакетот се придвижил.

Прво, утврдете што истекло

Барањето за следење може да не успее во неколку точки: прелистувачот може да престане да ја чека вашата апликација, вашата апликација може да престане да чека API за следење или тоа API може да истече додека контактира друга услуга. Корисникот може да ја види истата општа грешка во секој од овие случаи, но соодветното следно дејство е различно.

  • Истекување на страната на клиентот: Апликацијата престанала да чека. Барањето на страната на серверот можеби сепак завршило. Проверете ги сопствените дневници на барања или складиштето со резултати пред да испратите друго барање што би можело да ја дуплира работата.
  • Мрежен или поврзувачки неуспех: Вашиот систем не примил употреблив одговор. Можеби нема да знаете дали оддалечената услуга го обработила барањето.
  • HTTP 504: Гејтвејот или прокси-серверот не примил навремен одговор од надворешен сервер. Ова ја опишува патеката на барањето, а не пратката.
  • HTTP 408: Серверот не примил целосна порака со барањето во времето во кое бил подготвен да чека. Тоа не е статус за следење од превозник.
  • HTTP 200 со стар настан: Барањето успеало, но вратените информации за следење можеби сè уште се застарени. Успешниот HTTP одговор не е гаранција за свежина.

Евидентирајте ги овие исходи како дијагностика на барањето. Не преведувајте ниту еден од нив во ознаки за пратката како „во транзит“, „исклучок“ или „испорачано“. Тие ознаки треба да потекнуваат од настани за следење или од документирано статусно поле, а не од транспортниот слој.

Користете ограничено повторување, а не бесконечна јамка

За пребарување на следење само за читање, повторувањето по истекување на времето често е разумно. Сепак, тоа треба да биде ограничено. Повторените барања можат да го зголемат оптоварувањето на услуга што се соочува со проблеми, да го продолжат чекањето на корисникот и да создадат дуплирана работа кога повеќе слоеви на апликацијата повторуваат обиди независно.

  1. Поставете вкупен рок. Одлучете колку долго може да трае операцијата видлива за корисникот, вклучувајќи го првичниот обид и секое повторување. Не му давајте на секој обид нов, целосен рок што го надминува времето што повикувачот може да го чека.
  2. Проверете дали операцијата е безбедна за повторување. Пребарувањето обично се разликува од барање што регистрира пратка, менува поставки или создава ресурс. Не повторувајте автоматски барање што менува состојба освен ако договорот со давателот или вашите контроли за идемпотентност не го прават тоа безбедно.
  3. Повторете го привремениот неуспех внимателно. Користете мал, експлицитен буџет за повторување и доцнење со случајна варијација, наместо да испраќате истовремени непосредни повторувања од многу клиенти.
  4. Почитувајте ги важечките упатства од серверот. Ако одговорот содржи важечко заглавие Retry-After, не закажувајте порано повторување. Исто така, почитувајте го секое построго ограничување специфично за апликацијата или давателот.
  5. Запрете кога ќе истече рокот или буџетот. Префрлете се на резервен одговор и одделно закажете подоцнежно усогласување ако тоа му е потребно на вашиот работен тек.

Практичниот дизајн може да дозволи едно повторување видливо за корисникот ако останува доволно време, додека понатамошните обиди ги префрла во освежување во заднина. Тоа е пример за политика, а не универзално API правило. Изберете ги ограничувањата според целите на нивото на услугата, набљудуваната латентност и документацијата на давателот. Исто така, бројте ги повторувањата направени од HTTP библиотеките, гејтвеите и работниците за задачи; во спротивно, навидум скромната политика на апликацијата може да произведе многу повици кон надворешните услуги.

За HTTP 429, третирајте го одговорот како сигнал за ограничување на стапката, а не како причина за непосредно повторување. HTTP 503 може да укажува на привремена неспособност за обработка на барањето, а серверот може да испрати Retry-After. 504 може да биде привремен, но не гарантира дека следниот обид ќе успее. Грешките при автентикација обично бараат проверка на акредитивите или дозволите, додека неисправните барања бараат корекција на внесот. Идентификаторот за следење што дава резултат „не е пронајден“ бара поголема внимателност: зависно од документираното однесување на давателот и фазата на пратката, можеби е прерано за да се најде запис или идентификаторот можеби е погрешен. Не претворајте еден таков резултат во дефинитивно тврдење дека пакетот не постои.

Изберете резервна опција што го зачувува она што го знаете

Најбезбедната резервна опција обично е последниот потврден резултат од следењето, придружен со сопственото време на настанот и искрена ознака за свежина. Чувајте го тој резултат одделно од тековниот неуспех на барањето. Страницата може да каже: „Најново достапно ажурирање: Напуштен објект. Последна проверка: [време]. Поново ажурирање моментално не е достапно.“ Вклучете „Последна проверка“ само ако вашиот систем навистина го евидентира тоа; тоа не е замена за времето на настанот кај превозникот.

Користете го најпрецизното време што можете да го поткрепите. Времето на настанот кај превозникот опишува кога наводно се случил настанот. Времето кога вашиот систем го примил тој настан го опишува внесувањето. Времето кога корисникот ја отворил страницата не опишува ниту едно од овие. Ако изворот не обезбедува сигурно време на настанот или временска зона, избегнувајте да измислувате такво време. Исто така, ако кешираниот резултат нема евидентирано време на преземање, наречете го „последно достапно ажурирање“ наместо да тврдите дека неодамна бил освежен.

Резервната опција треба да следи три граници:

  • Прикажувајте ги кешираните податоци како кеширани податоци. Не прикажувајте постар настан како резултат на барањето на кое му истекло времето.
  • Не заклучувајте напредок од изминатото време. Пратката не е „излезена за испорака“ само затоа што била во транзит неколку дена.
  • Не ја прикривајте значајната неизвесност. Ако нема претходен резултат, кажете дека следењето моментално не е достапно наместо да прикажувате измислен стандарден статус.

Други резервни патеки може да вклучуваат претходно синхронизирано складиште за следење, овластено пребарување кај превозникот или подоцнежно освежување во заднина. Користете ги само ако се соодветни за пратката, вашите дозволи и условите на изворот на податоци. Вториот извор може да има различни имиња на настани или доцнења во известувањето, затоа зачувајте го потеклото и избегнувајте спојување на спротивставени записи без правило за тоа. Ако клиентот може да постапи врз основа на резултатот, обезбедете начин за повторен обид или контакт со поддршката наместо бесконечно прикажување на индикатор за вчитување.

Чувајте ги одделно статусот на барањето, свежината на податоците и статусот на пратката

Ова се три различни полиња, дури и ако корисничкиот интерфејс ги прикажува заедно. Статусот на барањето кажува дали пребарувањето успеало, истекло или добило грешка. Свежината на податоците кажува кога биле забележани вратените или складираните информации. Статусот на пратката кажува што известува изворот за следење за пакетот. Нивното одделување спречува привремен неуспех на API да избрише важечки настан за испорака или да претвори застарен настан „во транзит“ во тековно тврдење.

На пример, системот може да чува потврден настан „Испорачано“ од претходно пребарување додека тековното освежување истекува. Настанот за испорака не исчезнува. Точната комбинирана состојба е дека последниот достапен статус на пратката е „испорачано“, а најновото освежување не успеало. Спротивно, ако последниот настан е „Во транзит“, истекувањето на времето не потврдува дека пакетот во овој момент останува во транзит; потврдува само дека не е добиен понов одговор.

Применете дефинирано правило кога настаните пристигнуваат по различен редослед. Споредете ги идентификаторите на настаните, временските ознаки, изворот и документираната семантика на статусите на давателот кога е достапна. Не претпоставувајте дека редоследот по кој вашиот систем ги примил ажурирањата е редоследот по кој се случиле настаните на пратката. Ниту, пак, доцна пристигнат постар настан автоматски треба да замени понов потврден статус. Сепак, корекциите и исклучоците можат да бидат легитимни, затоа избегнувајте општо правило според кое промените на статусот по испораката се невозможни. Зачувајте ги основните настани и истражете ги противречностите наместо тивко да ја препишувате историјата.

Ако давателот врати HTTP 202, толкувајте го според договорот на конкретната крајна точка: прифаќањето на барањето само по себе не значи дека пребарувањето за следење е завршено. Слично, HTTP 200 потврдува дека HTTP барањето успеало според семантиката на таа крајна точка; не докажува дека секое поле за следење е присутно или тековно. Мапирајте ги полињата специфични за одговорот на давателот дури откако ќе ја проверите документацијата на давателот.

Направете го неуспехот видлив за операторите без да ги вознемирувате клиентите

Корисниот оперативен запис вклучува ID на барањето, крајната точка или операцијата, бројот на обиди, изминатото време, слојот на истекување, HTTP статусот ако е примен, и дали одговорот потекнувал од пребарување во живо или од резервна опција. За податоците за следење, евидентирајте го изворот и релевантните временски ознаки на настанот или преземањето. Ракувајте со броевите за следење и информациите за клиентите според правилата на вашата организација за пристап и задржување; дијагностичката корисност не е причина да се изложуваат целосни идентификатори во неограничени дневници.

Следете ги обрасците наместо да се потпирате на едно истекување. Зголемената стапка на истекување на една рута на превозник, повторените одговори 429 или зголемената разлика меѓу времето на настанот кај превозникот и времето на преземање може да укажуваат на различни проблеми. Првиот може да бара истрага кај давателот, вториот може да бара контрола на стапката, а третиот може да бара проверка на синхронизацијата или испораката на настаните. Ако апликацијата нуди следење преку давател како што е 17TRACK Tracking API, користете ја документацијата на тој давател за да ги проверите полињата специфични за одделните крајни точки, ограничувањата на барањата и постапувањето со грешки пред да ги примените овие општи правила.

За пораката наменета за клиентот, бидете прецизни и воздржани: „Моментално не можевме да го освежиме следењето. Еве го најновото достапно ажурирање.“ Наведете го следниот чекор кога е корисно, како повторна проверка подоцна или контакт со поддршката ако пратката го надминала очекуваниот рок за испорака што го навел продавачот или превозникот. Избегнувајте да ветувате време на освежување што вашиот систем не може да го гарантира.

Контролна листа за пуштање на тек за следење безбедeн при истекување

  • Потврдете кој слој го наметнува секое истекување и кој слој управува со повторувањата.
  • Поставете вкупен рок за барањето и одделен, ограничен буџет за повторувања.
  • Проверете дали операциите што автоматски се повторуваат се безбедни за повторување.
  • Почитувајте ги ограничувањата на стапката и важечките упатства Retry-After.
  • Чувајте го исходот од барањето одделно од статусот на пратката и историјата на настаните.
  • Означете ги резервните податоци и зачувајте го нивниот извор и временските ознаки кога се достапни.
  • Тестирајте сценарија без кеш, со застарен кеш, 429, 503, 504 и со доцнежни одговори.
  • Проверете дека истекувањето не може да активира неточно известување за испорака или да избрише потврден настан.

Основното правило е едноставно: повторете го барањето само кога тоа е безбедно и корисно; користете резервна опција само со информации што можете да ги идентификувате; и никогаш не извлекувајте заклучок за статусот на пратката од HTTP истекување.

ЧПП

Дали треба веднаш да го повторам барањето за следење на кое му истекло времето?

Не автоматски. Проверете дали операцијата е безбедна за повторување, дали вкупниот рок остава време за уште еден обид и дали упатството за ограничување на стапката не наложува да почекате. Кратко, ограничено повторување со случајна варијација може да биде соодветно за пребарување само за читање; повторените непосредни обиди се лош стандарден избор.

Дали HTTP 504 значи дека системот за следење на превозникот е недостапен?

Не. Тоа значи дека гејтвејот или прокси-серверот не примил навремен одговор од надворешната услуга. Проблемот може да биде каде било по таа патека на барањето. Тоа не ја утврдува целокупната достапност на превозникот или состојбата на пакетот.

Дали можам да го прикажам последниот познат статус по истекување?

Да, ако го означите како најнова достапна информација, а не како успешно освежување во живо. Прикажете го времето на настанот и времето на преземањето кога се познати и јасно наведете дека поново ажурирање не можело да се потврди.

Дали истекувањето треба да ја смени пратката од „во транзит“ во „исклучок“?

Не. Истекувањето е неуспех на барањето, а не настан за пратката. Променете го статусот на пратката само кога сигурен извор за следење ќе обезбеди настан или статус што ја поддржува промената.

Што ако барањето на кое му истекло времето создавало или регистрирало запис за следење?

Не претпоставувајте дека не успеало. Оддалечениот систем можеби го обработил пред да се изгуби одговорот. Проверете дали постои резултат и користете документиран механизам за идемпотентност или постапка за обновување одобрена од давателот пред повторно да го испратите.

Извори