Skip to main content
홈블로그가이드추적 업데이트 빈도를 설정하는 7가지 방법: 더 최신 데이터, 더 적은 API 요청

추적 업데이트 빈도를 설정하는 7가지 방법: 더 최신 데이터, 더 적은 API 요청

17TRACK

신선도 목표를 설정하고, 배송 상태에 따라 폴링 주기를 다르게 적용하며, 지원되는 경우 웹훅을 사용하고, 누락된 업데이트를 조정하며, 공유 결과를 캐시하고, 예약 작업을 일괄 처리하고, 오류나 속도 제한 발생 시 백오프하여 추적 업데이트 빈도를 구성하세요. 개발자와 운영팀의 목표는 가능한 한 짧은 간격이 아닙니다. 변경되지 않은 데이터를 반복적으로 요청하지 않으면서 유용한 배송 변경 사항을 시스템에 전달하는 것입니다.

추적 업데이트 빈도를 구성하는 7가지 방법 더 신선한 데이터 더 적은 요청

이러한 제어 기능은 일반적으로 추적 제공업체를 주문 관리 시스템, 지원 플랫폼 또는 고객용 추적 페이지에 연결하는 애플리케이션에 속합니다. 일부 제공업체는 자체 새로 고침 제어 기능도 제공합니다. 이 두 계층을 분리하세요. 애플리케이션의 요청 일정을 변경해도 제공업체가 운송업체를 확인하는 빈도가 반드시 바뀌는 것은 아닙니다.

먼저 제어할 수 있는 업데이트 빈도를 확인하세요

고객이 배송 업데이트를 확인하기 전에 업데이트는 여러 단계를 거칩니다. 운송업체가 이벤트를 기록하고, 추적 서비스가 이를 가져오며, 애플리케이션이 이를 수신하거나 검색하고, 인터페이스에 표시합니다. 어느 단계에서든 지연이 발생하면 추적 정보가 오래된 것처럼 보일 수 있습니다.

  • 운송업체 이벤트 가용성: 운송업체가 스캔 또는 상태 변경을 기록하고 게시하는 시점입니다.
  • 제공업체 새로 고침 빈도: 추적 서비스가 운송업체 정보를 확인하거나 수신하는 빈도입니다.
  • 애플리케이션 검색 빈도: 시스템이 정보를 요청하거나 수신 알림을 처리하는 빈도입니다.
  • 표시 새로 고침 빈도: 웹사이트, 앱 또는 지원 도구가 로컬 화면을 새로 고치는 빈도입니다.

제공업체를 더 자주 폴링하면 세 번째 지연을 줄일 수 있습니다. 문서화된 엔드포인트가 해당 작업을 명시적으로 수행하지 않는 한, 더 최신 운송업체 스캔을 보장하거나 상위 시스템의 새로 고침을 강제할 수는 없습니다. 일정을 변경하기 전에 API 요청이 저장된 추적 데이터를 읽는지, 새로 고침을 시작하는지 또는 다른 작업을 수행하는지 확인하세요.

17TRACK 통합의 경우 Tracking API 개요와 공식 API 문서부터 확인하세요. 업데이트 전달, 요청 제한 및 새로 고침 제어 기능을 포함하여 사용하려는 작업의 동작을 확인하세요. 아래의 일정 설정 패턴은 애플리케이션 측 권장 사항이며, 모든 간격이 구성 가능한 17TRACK 설정이라는 의미는 아닙니다.

1. 간격을 선택하기 전에 신선도 목표를 설정하세요

각 비즈니스 워크플로가 새로 제공된 이벤트를 얼마나 빨리 파악해야 하는지 정의하세요. 배송 예외 대기열에는 과거 배송 대시보드보다 더 짧은 목표가 필요할 수 있습니다. 두 워크플로에 동일한 폴링 간격을 적용하면 요청이 낭비되거나 더 긴급한 워크플로가 충분히 지원되지 않을 수 있습니다.

두 가지 측정값을 구분하세요. 마지막으로 성공적으로 검색한 이후의 시간과 최신 배송 이벤트의 경과 시간입니다. 성공적인 요청도 변경 사항이 없으면 오래된 이벤트를 반환할 수 있습니다. 이는 최근에 데이터를 검색하지 못한 실패한 통합과는 다릅니다.

코드 전체에 간격을 직접 삽입하지 말고 작은 구성 정책을 사용하세요:

  • 신선도 목표: 제공업체에서 데이터를 사용할 수 있게 된 시점과 애플리케이션에 수집되는 시점 사이에 허용되는 지연입니다.
  • 일반 폴링 간격: 대상 배송에 적용되는 기본 간격입니다.
  • 최대 조정 간격: 배송이 성공적인 확인 없이 지낼 수 있는 최대 시간입니다.
  • 요청 예산: 재시도, 조정 및 기타 API 작업을 고려한 후 사용할 수 있는 용량입니다.

계획 예시로 배송 12,000건을 매시간 개별 확인하면 재시도 전에도 하루에 288,000건의 예약 조회 요청이 발생합니다. 4시간마다 확인하면 72,000건이 발생합니다. 이는 예시 계산일 뿐 제공업체 제한이나 권장 간격이 아닙니다. 일괄 처리와 푸시 전달을 사용하면 계산이 달라집니다.

워크플로의 신선도 목표를 충족하는 가장 긴 간격을 선택한 다음, 상위 시스템의 데이터가 해당 간격을 유용하게 만들 만큼 충분히 최신인지 테스트하세요.

2. 배송 상태가 바뀌면 간격을 변경하세요

단일 일정은 배송의 동작 방식을 무시합니다. 첫 스캔을 기다리는 소포, 긴 운송 구간을 정상적으로 이동 중인 소포, 배송 임박 단계의 소포가 반드시 동일한 수준의 확인을 필요로 하는 것은 아닙니다.

배송 상태권장 일정 방식안전장치
최초 운송업체 정보 대기 중제한된 횟수로 확인한 다음 변경이 없으면 간격을 늘립니다.스캔 누락만으로 배송 실패라고 판단하지 않습니다.
정상 이동 중해당 서비스 또는 경로에 적용되는 기본 간격을 사용합니다.최대 조정 간격을 유지합니다.
배송 임박시기적절한 업데이트가 실제 조치를 지원하는 경우 더 짧은 간격을 고려합니다.추가 요청이 새로운 정보를 반환하는지 측정합니다.
예외 또는 장기간 비활성조사를 우선하고 제한된 모니터링 일정을 사용합니다.더 빠른 폴링으로 근본적인 예외가 해결되지는 않습니다.
배송 완료 또는 기타 종료 상태종료 확인을 완료한 후 정기 폴링에서 제외합니다.수정 사항과 정당한 재개를 허용합니다.

제공업체 상태를 내부 수명 주기에 명시적으로 매핑하세요. 반송된 배송, 배송 시도 실패 및 배송 완료를 모두 모니터링 중단 상태로 간주하지 마세요. 이들은 서로 다른 운영 결정을 필요로 할 수 있습니다.

각 배송에 다음 확인 가능 시각을 저장하고 의미 있는 이벤트가 도착하면 이를 다시 계산하세요. 이렇게 하면 일정 설정을 감사할 수 있으며 모든 레코드를 동일하게 처리하는 타이머에 의존하지 않게 됩니다.

3. 제공업체가 지원하는 경우 변경 사항에 웹훅을 사용하세요

폴링은 변경 사항이 있는지 묻는 방식입니다. 웹훅을 사용하면 업데이트가 제공될 때 제공업체가 애플리케이션에 알릴 수 있습니다. 필요한 이벤트와 전달 동작이 지원되는 경우, 활성 배송을 반복적으로 조회하는 대신 푸시 전달을 기본 수집 경로로 사용하세요.

웹훅이 상위 시스템의 지연을 없애지는 않습니다. 또한 전달 처리 요구 사항이 추가됩니다. 구현 전에 제공업체가 문서화한 인증 방식, 확인 응답 규칙, 재시도 동작 및 이벤트 식별자를 확인하세요.

  • 문서화된 방식을 사용하여 수신 요청을 인증합니다.
  • 성공적인 수신을 확인하기 전에 유효한 알림을 영구적으로 저장하거나 대기열에 넣습니다.
  • 알림을 멱등적으로 처리하여 반복 전달이 중복 고객 메시지를 발생시키지 않도록 합니다.
  • 지연되거나 순서가 뒤바뀐 이벤트를 처리하여 오래된 정보가 최신 상태를 덮어쓰지 않도록 합니다.
  • 처리 실패와 대기 중인 알림의 경과 시간을 모니터링합니다.

제공업체가 명시적으로 보장하지 않는 한 웹훅 전달이 정확히 한 번만 발생하거나 항상 시간순으로 전달된다고 가정하지 마세요. 늦게 도착한 정보를 무조건 적용하는 대신 평가할 수 있도록 배송 이벤트 기록을 현재 정규화된 상태와 분리하세요.

4. 두 번째 전체 폴링 루프 대신 대상 조정을 추가하세요

웹훅 기반 통합에도 복구 경로가 필요합니다. 엔드포인트를 사용할 수 없었거나, 수신 후 작업자가 실패했거나, 내부 매핑 오류로 인해 업데이트가 주문 레코드에 도달하지 못했을 수 있습니다.

조정은 저장된 상태가 제공업체의 상태와 일치하는지 확인합니다. 전체 배송 집단에 대해 빈번한 폴링을 다시 만드는 것이 아니라 확인이 필요한 레코드에 집중해야 합니다.

유용한 조정 대상에는 알림 처리에 실패한 배송, 최대 확인 간격을 초과한 레코드 및 알려진 장애의 영향을 받은 배송이 포함됩니다. 오래된 운송업체 이벤트만으로는 업데이트 누락의 증거라고 할 수 없습니다.

장애가 발생한 후 영향을 받은 레코드를 대기열에 넣고 통제된 요청 예산 내에서 처리하세요. 겹치는 복구 작업을 중복 제거하고, 성공적인 업데이트로 불일치가 이미 해결된 경우 중복 작업을 취소하세요. 모든 활성 배송에 대해 동시에 요청을 시작하지 마세요.

마지막으로 성공적으로 확인한 시각을 최신 이벤트 시각과 별도로 추적하세요. 그렇지 않으면 최근 스캔이 없는 소포가 제공업체에 새로운 정보가 없다는 사실을 시스템이 방금 확인했음에도 반복적으로 조정 대상이 될 수 있습니다.

5. 추적 데이터를 캐시하고 소비자 간 요청을 공유하세요

추적 페이지, 지원 대시보드, 알림 작업자 및 주문 시스템이 모두 동일한 배송을 요청할 수 있습니다. 각 소비자가 추적 제공업체에 독립적으로 요청하도록 하지 말고 공유 애플리케이션 레코드를 제공하세요.

최신 배송 상태를 검색 시각 및 관련 이벤트 시각과 함께 로컬에 저장하세요. 스케줄러 또는 웹훅 처리기가 해당 레코드를 업데이트하도록 합니다. 고객이 페이지를 새로 고친다고 해서 상위 시스템에 또 다른 요청을 자동으로 보내서는 안 됩니다.

캐싱과 함께 요청 병합도 사용하세요. 여러 소비자가 동일한 오래된 레코드를 동시에 요청하면 하나의 새로 고침 작업만 허용하고 나머지는 그 결과를 사용하거나 기다리게 하세요. 데이터가 계정 경계를 넘지 않도록 캐시 키와 액세스 확인을 올바르게 지정하세요.

엔드포인트가 ETag 또는 Last-Modified와 같은 HTTP 검증자를 지원하면 조건부 요청으로 응답 본문 전송량을 줄일 수 있습니다. 그러나 조건부 요청도 여전히 요청이며 제공업체 할당량에 포함될 수 있습니다. HTTP 캐싱 의미 체계는 RFC 9111에 정의되어 있습니다. 특정 추적 엔드포인트의 지원 여부는 별도로 확인해야 합니다.

인터페이스에서 신선도를 이해하기 쉽게 표시하세요. “마지막 확인”은 검색 시각을 설명해야 하고, “최신 배송 이벤트”는 운송업체 이벤트를 설명해야 합니다. 하나의 시각을 두 가지 모두를 나타내는 것처럼 표시하면 고객을 오도할 수 있습니다.

6. 대상 조회를 일괄 처리하고 요청을 시간에 분산하세요

관련 조회 엔드포인트가 요청당 여러 추적 레코드를 지원하는 경우 일괄 처리를 통해 HTTP 요청 수를 줄일 수 있습니다. 필요한 작업이 일괄 처리를 지원하는지 확인하세요. 일괄 등록을 지원한다고 해서 일괄 검색까지 자동으로 지원하는 것은 아닙니다.

또한 전송 효율성과 과금을 구분하세요. 여러 레코드를 포함한 하나의 HTTP 요청도 제공업체의 규칙에 따라 여러 할당량 단위 또는 과금 대상 조회를 소비할 수 있습니다.

실용적인 스케줄러는 다음을 수행해야 합니다:

  1. 다음 확인 가능 시각이 도래한 레코드를 선택합니다.
  2. 완료되었거나 일시 중지되었거나 이미 대기열에 추가된 레코드를 제외합니다.
  3. 문서화된 엔드포인트 및 페이로드 제한 내에서 대상 레코드를 그룹화합니다.
  4. 공유 속도 제한기를 통해 작업을 전달합니다.
  5. 각 항목의 결과를 기록하고 적절한 경우 실패했거나 해결되지 않은 항목만 재시도합니다.

모든 작업을 정각에 실행하지 말고 일정 설정 기간 전체에 걸쳐 분산하세요. 동기화된 요청 폭주를 줄이기 위해 지터라고도 하는 제한된 무작위 오프셋을 추가합니다. 해당 오프셋은 각 워크플로의 신선도 목표를 준수할 수 있을 만큼 작게 유지하세요.

배치를 채우기 위해 기다리면 긴급한 업데이트가 지연될 때 일괄 처리는 덜 유용합니다. 시간에 민감한 작업은 전체 배치가 없어도 진행되도록 허용하되, 동일한 전체 속도 예산 안에서 처리하세요.

7. 속도 제한, 실패 및 가치가 낮은 확인에 대응하세요

일반 업데이트 간격을 오류 재시도 간격으로도 사용해서는 안 됩니다. 사용할 수 없는 엔드포인트에는 실패 위에 또 다른 전체 예약 요청을 겹치는 대신 통제된 재시도가 필요합니다.

HTTP 429는 “Too Many Requests”를 의미하며, 응답에는 RFC 6585에 설명된 Retry-After 필드가 포함될 수 있습니다. 이 필드의 HTTP 의미 체계는 RFC 9110에 정의되어 있습니다. 제공업체의 관련 지침과 제공된 유효한 Retry-After 값을 따르세요. 그렇지 않으면 재시도 가능한 실패에 대해 지터를 포함한 제한된 지수 백오프를 사용하세요.

인증 실패나 잘못된 추적 입력을 무기한 재시도하지 마세요. 수정 작업으로 전달하세요. 서버 측 상태를 변경하는 작업의 경우 모호한 시간 초과 후 요청을 자동으로 반복하기 전에 재시도 안전성을 확인하세요.

일반 폴링도 별도로 조정하세요. 성공적인 확인을 반복해도 새로운 정보가 반환되지 않으면 배송의 신선도 범위 내에서 간격을 늘리는 것을 고려하세요. 의미 있는 이벤트로 소포가 더 시간에 민감한 단계로 이동하면 간격을 다시 줄이세요.

관련 할당량을 공유하는 모든 작업자에 대해 속도 제한을 적용하세요. 독립적인 작업자별 제한은 각각 규정을 준수하는 것처럼 보이지만 합산 트래픽이 계정 수준의 허용량을 초과할 수 있습니다.

신선도와 효율성을 함께 검증하세요

정책을 광범위하게 적용하기 전에 통제된 배송 그룹에서 테스트하세요. 배송 구성의 변화가 일정 개선으로 잘못 해석되지 않도록 운송업체, 경로 및 수명 주기 특성이 유사한 워크플로를 비교하세요.

  • 유용한 업데이트 수율: 의미 있는 정보를 추가하는 성공적인 확인의 비율입니다.
  • 확인 경과 시간: 마지막으로 제공업체 상태를 성공적으로 확인한 이후의 시간입니다.
  • 수집 지연: 해당 가용 시각을 확인할 수 있는 경우 제공업체에서 데이터를 사용할 수 있게 된 시점부터 애플리케이션이 수신한 시점까지의 시간입니다.
  • 요청 부하: 요청량, 속도 제한 응답, 재시도 및 대기열 깊이입니다.
  • 복구 품질: 조정을 통해 복구된 누락 변경 사항과 실패를 해결하는 데 걸린 시간입니다.

운송업체 이벤트에서 수집까지의 시간을 순수한 통합 지연이라고 부르지 마세요. 여기에는 애플리케이션이 직접 제어할 수 없는 상위 시스템의 게시 및 수집 지연이 포함될 수 있습니다. 효과적인 정책은 불필요한 검색을 줄이면서 운영상 중요한 변경 사항을 정의된 신선도 목표 내에서 유지합니다.

FAQ

배송 추적에 가장 적합한 폴링 간격은 무엇인가요?

보편적인 간격은 없습니다. 워크플로의 신선도 목표, 상위 시스템의 업데이트 동작, API 제한 및 요청 예산을 기준으로 선택하세요. 문서화된 기본값으로 시작하고 성공적인 확인의 가치를 측정한 다음 모든 배송의 폴링을 더 빠르게 만드는 대신 수명 주기 상태에 따라 조정하세요.

추적 페이지를 새로 고치면 새로운 운송업체 확인이 강제로 실행되나요?

반드시 그렇지는 않습니다. 페이지가 애플리케이션 캐시 또는 제공업체의 저장된 추적 데이터를 읽을 수 있습니다. 브라우저 새로 고침, API 조회 및 상위 운송업체 새로 고침은 서로 다른 작업입니다. 문서화된 동작이 이를 뒷받침하는 경우에만 새로 고침을 실시간이라고 설명하세요.

웹훅이 폴링을 완전히 대체할 수 있나요?

제공업체가 필요한 업데이트를 지원하는 경우 일상적인 폴링의 상당 부분을 대체할 수 있습니다. 실패와 불확실한 상태를 처리하기 위해 제한된 조정 프로세스를 유지하세요. 필요한 확인의 정도는 전달 보장, 복구 옵션 및 업데이트 누락의 결과에 따라 달라집니다.

배송 후 추적 요청을 언제 중단해야 하나요?

종료 확인을 완료한 후 배송 완료 건을 정기 활성 폴링에서 제외하세요. 워크플로와 제공업체 동작에 따라 제한된 확인 기간이 필요한지 결정하세요. 모든 완료 배송을 무기한 일정에 남겨두지 않으면서 수정 사항을 처리할 수 있는 기능은 유지하세요.

HTTP 요청을 줄이면 항상 API 요금이 줄어드나요?

아니요. 과금은 HTTP 요청 수가 아니라 배송, 추적 레코드, 작업 또는 다른 계약상 단위를 기준으로 할 수 있습니다. 일괄 처리, 캐싱 또는 웹훅 도입으로 인한 비용 절감을 산정하기 전에 적용되는 측정 규칙을 확인하세요.

출처