2014-02-12 68 views
0

發生USPS異常時會填充什麼信息? API名稱是Tracking & Delivery Information.如何處理USPS API集成中的異常情況?

我已經在我的機器上成功集成了USPS API。我能夠通過追蹤號碼獲得產品狀態,但可能會有API異常可能發生的情況,我想管理該狀況的警報,以便我可以通知該情況。我想知道如何檢測異常?

+0

什麼API您使用的? https://www.usps.com/business/web-tools-apis/track-and-confirm-v1-3a.pdf – Charlie

+0

跟蹤與交付信息API。我已經檢查過,但它沒有幫助我。 –

回答

2

我發現自己造成

但大量的研究後,我發現我的問題的解決方案。這是如下:

在USPS「跟蹤&配送信息」 API集成有XML請求格式的兩種類型,我們可以發送到USPS服務器,用於提取出兩種不同的方式,通過追蹤號碼的包裹託運的響應。

1)跟蹤/確認Web工具: - 僅用於顯示目的,並作爲響應僅返回文本消息(摘要和詳細信息)。

API簽名(URL):
http://production.shippingapis.com/ShippingAPI.dll?API=TrackV2   // Live服務器
或者
http://production.shippingapis.com/ShippingAPITest.dll?API=TrackV2   //測試服務器

請求參數:

<TrackRequest USERID=」xxxxxxxx」> 
    <TrackID ID="EJ123456780US"></TrackID> 
</TrackRequest> 

它返回響應參數:總結和僅限細節

<TrackResponse> 
    <TrackInfo ID="E123456780US"> 
    <TrackSummary> 
     Your item was delivered at 6:50 am on February 6 in BARTOW FL 33830.   
    </TrackSummary> 
    <TrackDetail>February 6 6:49 am NOTICE LEFT BARTOW FL 33830</TrackDetail> 
    <TrackDetail>February 6 6:48 am ARRIVAL AT UNIT BARTOW FL 33830</TrackDetail> 
    <TrackDetail>February 6 3:49 am ARRIVAL AT UNIT LAKELAND FL 33805</TrackDetail> 
    <TrackDetail>February 5 7:28 pm ENROUTE 33699</TrackDetail> 
    <TrackDetail>February 5 7:18 pm ACCEPT OR PICKUP 33699</TrackDetail> 
    </TrackInfo> 
</TrackResponse> 

2)跟蹤/確認字段Web工具: - 這是對我有用的請求格式,我通過實現這個來測試它。此請求將返回像一個包裹跟蹤號碼的全部信息: - API簽名(URL):同用於第一個

請求示例:

<TrackFieldRequest USERID=" xxxxxxxx"> 
<TrackID ID="01805213907042762274"></TrackID> 
</TrackFieldRequest> 

響應示例:

<TrackResponse> 
    <TrackInfo ID="01805213907042762274"> 
     <TrackSummary> 
      <EventTime>12:12 pm</EventTime> 
      <EventDate>May 21, 2001</EventDate> 
      <Event>DELIVERED</Event> 
      <EventCity>NEWTON</EventCity> 
      <EventState>IA</EventState> 
      <EventZIPCode>50208</EventZIPCode> 
      <EventCountry/> 
      <FirmName></FirmName> 
      <Name></Name> 
      <AuthorizedAgent></AuthorizedAgent> 
     </TrackSummary> 
     <TrackDetail> 
      <EventTime>9:24 pm</EventTime> 
      <EventDate>March 28, 2001</EventDate> 
      <Event>ENROUTE</Event> 
      <EventCity>DES MOINES</EventCity> 
      <EventState>IA</EventState> 
      <EventZIPCode>50395</EventZIPCode> 
      <EventCountry/> 
      <FirmName/> 
      <Name/> 
      <AuthorizedAgent/> 
     </TrackDetail> 
    . 
    . 
    . 
</TrackResponse> 

注意:我已將此XML響應轉換爲簡單的PHP數組,並使用「事件」字段管理所有條件的警報 與ENROUTE/DELIVERED等類似。並管理由其錯誤ID發生的錯誤/異常,該錯誤ID返回它的響應數組。

See for More details

2

我已使用EasyPost API獲取更詳細的跟蹤和傳遞信息?這可能有幫助嗎?我發現USPS例外通知不是非常有用。

否則,您可以設置異常通知服務,以在發生API異常時提醒您。

+0

感謝您的回覆,但它沒有幫助我。 –

1

我注意到有這個API,你在哪裏得到的迴應更大量信息的另一種形式。在「XML」的查詢字符串參數傳遞這個XML文檔:

<TrackFieldRequest USERID="XXXXXXXX"> 
    <Revision>1</Revision> 
    <ClientIp>x.x.x.x</ClientIp> 
    <SourceId>customer/company name</SourceId> 
    <TrackID ID="9102xxxxxxxxx"></TrackID> 
</TrackFieldRequest> 

而與此XML文檔的響應的樣子:

<TrackResponse> 
    <TrackInfo ID="9102xxxxxx"> 
    <Class>Priority Mail 3-Day<SUP>&#153;</SUP></Class> 
    <ClassOfMailCode>PM</ClassOfMailCode> 
    <DestinationCity>TOMAHAWK</DestinationCity> 
    <DestinationState>WI</DestinationState> 
    <DestinationZip>54487</DestinationZip> 
    <EmailEnabled>true</EmailEnabled> 
    <ExpectedDeliveryDate>March 4, 2014</ExpectedDeliveryDate> 
    <KahalaIndicator>false</KahalaIndicator> 
    <MailTypeCode>DM</MailTypeCode> 
    <MPDATE>2014-03-01 20:19:24.000000</MPDATE> 
    <MPSUFFIX>121219566</MPSUFFIX> 
    <OriginCity>EAST FALMOUTH</OriginCity> 
    <OriginState>MA</OriginState> 
    <OriginZip>02536</OriginZip> 
    <PodEnabled>false</PodEnabled> 
    <RestoreEnabled>false</RestoreEnabled> 
    <RreEnabled>false</RreEnabled> 
    <Service>$50 insurance included</Service> 
    <Service>USPS Tracking<SUP>&#153;</SUP></Service> 
    <ServiceTypeCode>055</ServiceTypeCode> 
    <Status>Processed at USPS Origin Sort Facility</Status> 
    <StatusCategory>In Transit</StatusCategory> 
    <StatusSummary>Your item has been processed at the origin sort facility at 11:45 pm on March 1, 2014 in NASHUA, NH 03063.</StatusSummary> 
    <TABLECODE>T</TABLECODE> 
    <TrackSummary> 
     <EventTime>11:45 pm</EventTime> 
     <EventDate>March 1, 2014</EventDate> 
     <Event>Processed at USPS Origin Sort Facility</Event> 
     <EventCity>NASHUA</EventCity> 
     <EventState>NH</EventState> 
     <EventZIPCode>03063</EventZIPCode> 
     <EventCountry/> 
     <FirmName/><Name/><AuthorizedAgent>false</AuthorizedAgent> 
     <EventCode>10</EventCode> 
    </TrackSummary> 
    <TrackDetail> 
     <EventTime/> 
     <EventDate>March 1, 2014</EventDate> 
     <Event>Electronic Shipping Info Received</Event> 
. . .