Skip to main content
ДомаБлогВодичи7 начини за конфигурирање на фреквенцијата на ажурирање на следењето: посвежи податоци, помалку API-барања

7 начини за конфигурирање на фреквенцијата на ажурирање на следењето: посвежи податоци, помалку API-барања

17TRACK

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

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

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

Најпрво, утврдете која фреквенција на ажурирање можете да ја контролирате

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

  • Достапност на настанот кај превозникот: Кога превозникот скенира и објавува настан или промена на статусот.
  • Фреквенција на освежување кај провајдерот: Кога услугата за следење ги проверува или ги прима информациите од превозникот.
  • Фреквенција на преземање од апликацијата: Кога вашиот систем бара информации или ги обработува пристигнатите известувања.
  • Фреквенција на освежување на приказот: Кога вашата веб-страница, апликација или алатка за поддршка го освежува локалниот приказ.

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

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

1. Поставете цел за свежина пред да изберете интервал

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

Одделете две мерења: времето од последното успешно преземање и староста на најновиот настан на пратката. Успешното барање може да врати стар настан бидејќи ништо не се променило. Тоа се разликува од неуспешна интеграција која неодамна не презела податоци.

Користете мала конфигурациска политика наместо да вградувате интервали низ целиот код:

  • Цел за свежина: Прифатливото доцнење помеѓу достапноста кај провајдерот и внесувањето во апликацијата.
  • Нормален интервал на испитување: Стандардниот интервал за пратките што ги исполнуваат условите.
  • Максимален јаз за усогласување: Колку долго пратката може да остане без успешна проверка.
  • Буџет на барања: Достапниот капацитет по пресметувањето на повторните обиди, усогласувањето и другите API-операции.

Како пример за планирање, проверката на 12.000 пратки поединечно секој час би создала 288.000 закажани барања за пребарување дневно, пред повторните обиди. Проверката на секои четири часа би создала 72.000. Ова се илустративни пресметки, а не ограничувања или препорачани интервали од провајдерот; групирањето и испораката со push би ја промениле пресметката.

Изберете го најдолгиот интервал што ја исполнува целта за свежина на процесот, а потоа тестирајте дали податоците нагоре во синџирот се доволно свежи за тој интервал да биде корисен.

2. Менувајте го интервалот додека пратката ја менува состојбата

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

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

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

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

3. Користете вебхукови за промени кога провајдерот ги поддржува

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

Вебхуковите не ги отстрануваат доцнењата нагоре во синџирот. Тие воведуваат и барања за обработка на испораката. Пред имплементацијата проверете го документираниот механизам за автентикација на провајдерот, правилата за потврда, однесувањето при повторни обиди и идентификаторите на настаните.

  • Автентифицирајте ги дојдовните барања со документираниот механизам.
  • Трајно зачувајте или ставете во редица валидно известување пред да потврдите успешно примање.
  • Обработувајте ги известувањата идемпотентно за повторната испорака да не предизвика дупликатни пораки до клиентите.
  • Обработувајте ги задоцнетите и настаните што пристигнуваат по погрешен редослед без постарата информација да ја препише поновата состојба.
  • Следете ги неуспесите при обработка и староста на известувањата во редицата.

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

4. Додајте насочено усогласување наместо втор целосен циклус на испитување

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

Усогласувањето проверува дали вашата зачувана состојба се совпаѓа со состојбата кај провајдерот. Треба да се фокусира на записите што имаат потреба од проверка, а не повторно да создава често испитување на целата популација на пратки.

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

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

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

5. Кеширајте ги податоците за следење и споделувајте ги барањата меѓу корисниците

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

Зачувајте ја локално последната позната состојба на пратката, заедно со времето на преземање и релевантните временски ознаки на настаните. Дозволете му на распоредувачот или обработувачот на вебхукови да го ажурира тој запис. Освежувањето на страницата од страна на клиентот не треба автоматски да предизвикува ново барање нагоре во синџирот.

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

Ако крајниот пункт поддржува HTTP валидатори како ETag или Last-Modified, условните барања може да го намалат преносот на телото на одговорот. Сепак, условното барање сè уште е барање и може да се брои во квотата на провајдерот. Семантиката на HTTP кеширањето е дефинирана во RFC 9111; поддршката за конкретен краен пункт за следење мора да се провери одделно.

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

6. Групирајте ги проверките и распоредете ги барањата низ времето

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

Исто така разликувајте ја транспортната ефикасност од наплатата. Едно HTTP-барање со повеќе записи сепак може да троши повеќе единици од квотата или наплатливи пребарувања, зависно од правилата на провајдерот.

Практичниот распоредувач треба да:

  1. Ги избере записите чијшто следен дозволен термин за проверка пристигнал.
  2. Ги исклучи завршените, паузираните или веќе ставените во редица записи.
  3. Ги групира записите во рамките на документираните ограничувања на крајниот пункт и корисниот товар.
  4. Ја испрати работата преку споделен ограничувач на стапката.
  5. Го евидентира резултатот за секоја ставка и повторно да се обиде само со неуспешните или нерешените ставки кога е соодветно.

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

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

7. Приспособете се на ограничувањата на стапката, неуспесите и проверките со мала вредност

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

HTTP 429 значи „Too Many Requests“, а одговорот може да содржи поле Retry-After, како што е опишано во RFC 6585. HTTP-семантиката на полето е дефинирана во RFC 9110. Следете ги применливите упатства на провајдерот и валидната вредност на Retry-After кога е доставена. Во спротивно, користете ограничено експоненцијално повлекување со jitter за грешките што може повторно да се обидат.

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

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

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

Проверувајте ги свежината и ефикасноста заедно

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

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

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

ЧПП

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

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

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

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

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

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

Кога треба да престанат барањата за следење по испораката?

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

Дали помалку HTTP-барања секогаш ќе ги намалат трошоците за API?

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

Извори