บทนำ
API สำหรับการตรวจสอบที่อยู่เป็นโซลูชันที่แก้ไขปัญหารายละเอียดการติดต่อไม่ถูกต้องได้อย่างชาญฉลาด และยังช่วยให้จัดส่งพัสดุได้รวดเร็วกว่าเดิมและแม่นยำ API นี้กำหนดรูปแบบการป้อนข้อมูลที่อยู่ผู้รับที่เหมาะสมโดยมีความใกล้เคียงกับที่อยู่ที่ถูกต้อง ทั้งยังแสดงที่อยู่ตามตำแหน่งจริงที่ค่อนข้างตรงกับที่อยู่ที่ต้องการ
API นี้แสดงข้อมูลประกอบที่บ่งชี้ข้อบกพร่องของที่อยู่ที่ป้อนหรือการแก้ไขข้อมูลที่อยู่สำหรับจัดส่งตามตำแหน่งจริงนั้นๆ คุณยังสามารถใช้ API นี้ตรวจสอบความถูกต้องและแก้ไขข้อมูลที่อยู่ผู้รับก่อนจัดส่งพัสดุได้อีกด้วย
หมายเหตุ: ห้ามใช้ API นี้เพื่อพิจารณาความพร้อมในการจัดส่งของที่อยู่ FedEx ไม่มีบริการจัดส่งไปยังที่อยู่ที่ถูกต้องได้ครบทุกแห่ง FedEx ไม่มีบริการจัดส่งไปยังตู้ไปรษณีย์ ยกเว้นการจัดส่งผ่าน FedEx Ground® Economy (เดิมเรียกว่า FedEx SmartPost®)
รายละเอียด API สำหรับการตรวจสอบที่อยู่
API นี้สามารถช่วยตรวจสอบและแก้ไขข้อมูลที่อยู่ผู้รับก่อนการจัดส่งได้ ที่อยู่ที่ถูกต้องที่ฉลากการส่งจะช่วยกำจัดความล่าช้าในการส่งและค่าแก้ไขที่อยู่เพิ่มเติม (จากการใส่ที่อยู่ไม่ถูกต้อง)
หมายเหตุ:
- ผลลัพธ์การแก้ปัญหาของที่อยู่จะแตกต่างกันไปในแต่ละประเทศ/เขตปกครอง
- ที่อยู่ที่กรอกในคำขอจะนำไปเปรียบกับข้อมูลอ้างอิงที่ฐานข้อมูลของ FedEx และจะส่งคืนที่อยู่ที่ตรงกันกลับไป
หน้าที่การทำงานของ API สำหรับการตรวจสอบที่อยู่
- ให้ข้อมูลที่ตรงกันสำหรับที่อยู่ในระดับถนน
- ได้รับข้อมูลล่าสุดรายเดือนสำหรับฐานข้อมูลที่อยู่
- แยกแยะความแตกต่างระหว่างที่อยู่ประเภทธุรกิจและประเภทบ้านพักอาศัยหากพบข้อมูลที่ตรงกัน
- ในขณะนี้ยังไม่ตรวจสอบหมายเลขห้องชุดหรืออพาร์ตเมนต์
ความสามารถของ API สำหรับการตรวจสอบที่อยู่
- กรอกที่อยู่ที่ไม่ครบถ้วนให้ครบถ้วน ในบางกรณี API การตรวจสอบที่อยู่จะสามารถเติมข้อมูลที่หายไปได้โดยขึ้นอยู่กับการตรวจสอบข้อมูลที่ให้ไว้กับข้อมูลอ้างอิง API การตรวจสอบที่อยู่ไม่สามารถเพิ่มข้อมูลระดับรอง (เช่น อพาร์ตเมนต์หรือห้องชุด) ได้ในขณะนี้
- ได้รับข้อมูลล่าสุดรายเดือนสำหรับฐานข้อมูลที่อยู่
- แก้ไขที่อยู่ผู้รับที่ไม่ถูกต้อง เช่น แก้ไขรหัสไปรษณีย์ที่ไม่ถูกต้องเพื่อให้ตรงกับข้อมูลอื่น ๆ ที่ให้ไว้
- ตัดสินว่าที่อยู่เป็นที่อยู่ธุรกิจหรือที่อยู่อาศัยเพื่อเพิ่มความแม่นยำของข้อเสนออัตราพิเศษ ใช้ได้กับที่อยู่ในสหรัฐฯและแคนาดาเท่านั้น
- ยืนยันความถูกต้องและความสมบูรณ์ของที่อยู่ในหลายประเทศในพื้นที่ต่อไปนี้: สหรัฐฯ แคนาดา ละตินอเมริกา ยุโรป ตะวันออกกลาง และเอเชียแปซิฟิก คุณสามารถตรวจสอบข้อมูลที่อยู่ทั้งในประเทศและนอกประเทศก่อนจะส่งพัสดุได้ หลีกเลี่ยงความล่าช้าในการส่งและค่าใช้จ่ายสำหรับบริการเพิ่มเติมอื่น ๆ
- ให้การตรวจสอบในระดับถนน
- สามารถตรวจสอบได้สูงสุด 100 ที่อยู่ต่อหนึ่งคำของ API
ประเทศ/ตำแหน่งที่รองรับ API การตรวจสอบที่อยู่
คุณสามารถใช้ API การตรวจสอบที่ของ FedEx ได้ในประเทศต่อไปนี้เพื่อตรวจสอบและแก้ไขที่อยู่ของผู้รับเพื่อการส่งที่มีประสิทธิภาพ
แอนทิลลีส | เดนมาร์ก | ปานามา |
อาร์เจนตินา | สาธารณรัฐโดมินิกัน | เปรู |
อารูบา | เอสโตเนีย | โปรตุเกส |
ออสเตรเลีย | ฟินแลนด์ | สิงคโปร์ |
ออสเตรีย | ฝรั่งเศส | แอฟริกาใต้ |
บาฮามาส | เยอรมนี | สเปน |
บาร์เบโดส | กรีซ | สวีเดน |
เบลเยียม | กัวเตมาลา | สวิตเซอร์แลนด์ |
เบอร์มิวดา | เขตบริหารพิเศษฮ่องกง, จีน | ตรินิแดดและโตเบโก |
บราซิล | อิตาลี | สหราชอาณาจักร |
แคนาดา | จาไมกา | สหรัฐอเมริกา |
หมู่เกาะเคย์แมน | มาเลเซีย | อุรุกวัย |
ชิลี | เม็กซิโก | เวเนซุเอลา |
โคลัมเบีย | เนเธอร์แลนด์ | Virgin Islands |
คอสตาริกา | นิวซีแลนด์ | |
สาธารณรัฐเช็ก | นอร์เวย์ |
หมายเหตุ: ข้อมูลที่ส่งกลับโดยคำขอการตรวจสอบที่อยู่เป็นข้อมูลที่ใช้สำหรับการแนะนำเท่านั้น
หมายเหตุด้านกฎหมาย: ข้อมูลที่ให้ไว้ที่นี่เป็นกรรมสิทธิ์ของ FedEx และเป็นข้อมูลที่เป็นความลับที่ให้ไว้โดยเป็นการอนุญาตจากคำขอของคุณ ไม่มีส่วนใดของข้อมูลนี้สามารถนำไปแจกจ่ายหรือเปิดเผยในรูปแบบใด ๆ กับบุคลลที่สามโดยไม่มีการอนุญาติเป็นลายลักษณ์อักษรของ FedEx สิ่งนี้จะสะท้อนการจัดประเภทระดับที่อยู่ของธุรกิจ/ที่อยู่อาศัยของ FedEx ในฐานข้อมูลการส่งของ FedEx และยังสามารถเปลี่ยนแปลงได้ ในการจัดการกับข้อมูลเหล่านี้ FedEx ไม่สามารถการันตีความแม่นยำในปัจจุบันและในอนาคตได้ และไม่การันตีว่าพัสดุที่ส่งไปที่อยู่เหล่านี้จะส่งใบเรียกเก็บเงินตรงกับประเภทธุรกิจ/ที่อยู่อาศัยที่ให้ไว้ที่นี่ การให้ข้อมูลนี้ไม่ควรจะถือว่าเป็นสิ่งที่เปลี่ยนแปลงข้อกำหนดระหว่างแต่ละฝ่ายได้ ดูที่ คู่มือบริการ ของ FedEx หรือข้อตกลงด้านราคาบัญชีที่เกี่ยวข้องอื่นๆ สำหรับข้อกำหนดและเงื่อนไขที่กำหนดการส่งและการเรียกเก็บเงินของ FedEx
API สำหรับการตรวจสอบที่อยู่ทำงานอย่างไร
ตรวจสอบที่อยู่
ใช้ปลายทางนี้เพื่อยืนยันและแก้ไขที่อยู่ที่กรอกไว้และให้ที่อยู่ที่มีจริงกลับคืน รายละเอียดของที่อยู่จะต้องให้และตรวจสอบเพื่อแก้ปัญหาของที่อยู่ ที่อยู่จะแสดงว่าแก้ไขแล้วเมื่อที่อยู่ที่กรอกตรงกับข้อมูลอ้างอิงที่มี
ข้อมูลที่เกี่ยวข้องกับคำขอนี้ได้แก่:
- ถนน
- เมือง (ถ้ามี)
- รหัสรัฐหรือจังหวัด (ถ้ามี)
- รหัสไปรษณีย์ (ถ้ามี)
- รหัสประเทศ
หมายเหตุ: รหัสรัฐและชื่อเมืองก็เพียงพอแล้วเมื่อลูกค้าจะส่งไปที่ประเทศที่ไม่มีรหัสไปรษณีย์
API การตรวจสอบที่อยู่จะให้ที่อยู่จริงกลับไปโดยทำปฏิบัติการต่อไปนี้กับที่อยู่ที่ให้ไว้:
- ในขั้นตอนแรก API จะพยายามทำให้ที่อยู่ที่ให้ไว้เป็นปกติ ขั้นตอนนี้อาจจะประกอบด้วยการแทนที่สิ่งที่ระบุทางถนนทั่วไปอย่างเช่น Street หรือ Parkway ด้วยการย่อตามมาตรฐานเช่น ST และ PKWY รวมถึงการเรียงลำดับองค์ประกอบต่าง ๆ ของที่อยู่ใหม่ ถ้าที่อยู่ที่ให้ไว้ไม่สามารถทำให้เป็นปกติได้ ที่อยู่ที่แก้ปัญหาแล้วจะเป็นที่อยู่ที่ให้ไว้ จะนำค่าต่าง ๆ ที่ไม่ใช่ที่อยู่ออกไป
- ในขั้นตอนที่สอง API จะพยายามทำข้อมูลที่เป็นปกติให้เป็นมาตรฐานโดยการหาที่อยู่ที่เป็นไปได้หรือที่อยู่จริงที่น่าจะเป็นที่อยู่ที่ผู้ใช้ต้องการ ถ้ากระบวนการการทำให้เป็นมาตรฐานล้มเหลว ที่อยู่ที่แก้ปัญหาแล้วจะเป็นที่อยู่ในรูปแบบปกติของที่อยู่ที่ให้ไว้ อ้างอิงจากองค์ประกอบที่ให้กลับไปเพื่อช่วยมองหาปัญหาที่มีในที่อยู่ที่ให้ไว้
- องค์ประกอบบางอย่างของที่อยู่แบบปกติก็จะคืนกลับมาด้วย ถ้าการทำให้เป็นมาตรฐานสำเร็จ ที่อยู่ที่แก้ปัญหาที่ให้กลับไปจะเป็นที่อยู่จริง ในกรณีนี้ องค์ประกอบเพิ่มเติมหลาย ๆ อย่างของที่อยู่ที่เป็นมาตรฐานแล้วและข้อมูลที่ได้จากที่อยู่ที่เป็นปกติก็จะคืนมาด้วย
ค่าการแสดงผลของ API สำหรับการตรวจสอบที่อยู่
หากที่อยู่ที่แสดงประกอบด้วยค่าต่อไปนี้สำหรับคุณลักษณะด้านล่าง ที่อยู่จะเป็นที่อยู่ที่ถูกต้อง:
- รัฐตามที่อยู่เป็นมาตรฐาน
- คุณลักษณะของที่อยู่ที่ถูกแก้ไขเป็นจริง
- จุดจัดส่ง (DPV) ถูกต้อง
- ที่อยู่ที่แทรกเป็นเท็จ
ากไม่มีคุณลักษณะเหล่านี้ ให้ใช้คุณลักษณะเพิ่มเติมในการค้นหาปัญหาของค่าที่อยู่ที่เป็นไปได้
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคุณลักษณะของที่อยู่ ดูที่ คุณลักษณะของที่อยู่
หากข้อมูลที่แสดงรหัสข้อความลูกค้า คือ INTERPOLATED.STREET.ADDRESS ก็จะมีโอกาสที่ที่อยู่ไม่ถูกต้อง สำหรับข้อมูลเพิ่มเติมเกี่ยวกับรหัสข้อความลูกค้า ดูที่คำอธิบายองค์ประกอบของข้อความลูกค้า
คำอธิบายประกอบ
API สำหรับการตรวจสอบที่อยู่แสดงคำอธิบายประกอบพร้อมทุกที่อยู่ที่ตรวจสอบและแสดงแล้ว คำอธิบายประกอบให้ข้อมูลแก่คุณเกี่ยวกับข้อบกพร่องเมื่อเกิดขึ้นและการเปลี่ยนแปลงที่ทำกับที่อยู่ที่ป้อนเพื่อไปให้ถึงที่อยู่ตามตำแหน่งจริงนั้น
การจำแนกที่อยู่
API สำหรับการตรวจสอบที่อยู่ใช้ข้อมูลอ้างอิงเพื่อระบุประเภทของที่อยู่ที่ให้ไว้ การจัดประเภทของที่อยู่ที่ใช้ได้จะคำนวนแยกกันโดยใช้กระบวนการยืนยันที่อยู่และใช้ความคิดเห็นเจ้าหน้าที่ปฏิบัติการเป็นสิ่งอ้างอิง โดยใช้แหล่งข้อมูลเชิงพาณิชย์เพื่อการยืนยันเท่านั้น.
API การยืนยันที่อยู่มีการจัดประเภทที่เป็นไปได้สี่ประเภทสำหรับที่อยู่เท่านั้น: ไม่ทราบ ธุรกิจ ที่อยู่อาศัย และแบบผสม ทุกที่อยู่จะเริ่มจากประเภท 'ไม่ทราบ' และจะเป็นเช่นนั้นไปจนกว่ากฎการตรวจสอบที่อยู่ทางธุรกิจระบุว่าควรจะเปลี่ยนประเภทของที่อยู่นั้น ที่อยู่จะได้รับประเภท 'แบบผสม' ก็ต่อเมื่อเป็นที่อยู่ที่มีผู้เช่าหลายคนและมีทั้งยูนิตที่เป็นธุรกิจและที่อยู่อาศัยเท่านั้น
หมายเหตุ: บริการ FedEx Express ให้บรรทัดที่อยู่เพิ่มเติม (บรรทัดที่อยู่ 3) สำหรับที่อยู่ของผู้รับ ข้อมูลที่อยู่เพิ่มเติมนี้จะให้ข้อมูลที่อยู่สมบูรณ์และเที่ยงตรงมากว่า เพิ่มโอกาสที่จะได้ที่อยู่ที่ถูกต้องมากขึ้น
ที่อยู่ที่มีจริงจะแบ่งเป็นประเภทดังนี้:
ที่อยู่ทางธุรกิจ
ที่อยู่ทางธุรกิจคือที่อยู่ที่ใช้เพื่อระบุสถานที่ตั้งหลักของธุรกิจ เป็นตำแหน่งที่ธุรกิจของคุณควรเปิดทำการ แต่อาจจะไม่ได้เป็นเช่นนั้นเสมอไป
ที่อยู่ทางธุรกิจคือที่ตั้งอย่างเป็นทางการของบริเวณสถานที่บริษัท าจเป็นแบบใดก็ได้ตั้งแต่บ้านที่อยู่ของใครสักคนไปจนถึงวิทยาเขตราคาหลายล้านดอลลาร์ เช่น กลุ่มสถานที่ที่บริษัทเทคโนโลยีขนาดใหญ่นิยมกันและสถานที่อื่นที่คล้ายกัน
ที่อยู่ของที่พักอาศัย
ค่าธรรมเนียมในการจัดส่งไปยังที่พักอาศัยจะบังคับใช้กับการจัดส่งภายในสหรัฐอเมริกาไปยังบ้านหรือบ้านพักอาศัยส่วนตัว รวมถึงตำแหน่งที่ธุรกิจเปิดทำการจากบ้าน ใช้ FedEx Home Delivery สำหรับการจัดส่งไปยังที่พักอาศัยผ่าน FedEx Ground ใน 1 วันทำการ โดยขึ้นอยู่กับระยะทางถึงปลายทาง
ตัวอย่าง:
- บ้านพักนักบวช
- สำนักแม่ชี
- กุฏิพระ
- ผู้อยู่อาศัยในที่อยู่อาศัยหลายยูนิต เช่น:
- อาคารอพาร์ทเมนต์
- คอนโดมิเนียม
- หอพักของวิทยาลัย
- ที่พักอาศัยที่มีการขายและ/หรือแจกจ่ายผลิตภัณฑ์
คำแนะนำในการใช้ API สำหรับการตรวจสอบที่อยู่
ต่อไปนี้คือเคล็ดลับที่มีประโยชน์สำหรับการใช้ API การตรวจสอบที่อยู่
- ใช้การเว้นวรรคอย่างถูกต้อง: ดูให้แน่ใจว่าใส่เว้นวรรคได้อย่างถูกต้องและหลีกเลี่ยงการเว้นวรรคที่ไม่จำเป็น
- ใช้การสะกดที่ถูกต้อง: หลีกเลี่ยงความผิดพลาดจากการสะกดหรือการพิมพ์ และตรวจสอบให้แน่ใจว่าคุณใช้หมายเลขศูนย์ (0) และตัวอักษร O อย่างถูกต้อง
- หลีกเลี่ยงอักขระพิเศษ: โปรดงดเว้นการใช้ตัวอักขระพิเศษที่ไม่จำเป็นต้องใช้สำหรับที่อยู่ เช่น จุดหลังตัวย่อ (Ave กับ Ave.)
- ให้ข้อมูลที่อยู่และถนนเพิ่มเติม: การให้ข้อมูลที่อยู่เพิ่มเติมจะสามารถเพิ่มความแม่นยำของผลลัพธ์ที่อยู่ได้
- หมายเลขอาคารหรือบ้าน - 1, 1A, 1½, หนึ่ง
- ชื่อถนน - Main, George Washington, เลขที่ 42
- คำต่อท้ายถนน - ถนน, Avenue, ถ., Ave
- ป้อนเมือง รัฐ/จังหวัด และรหัสไปรษณีย์: การให้ข้อมูลครบทั้งสามส่วนจะเพิ่มความแม่นยำผลลัพธ์การค้นหาที่อยู่ของคุณ
- ป้อนชื่อถนนและที่อยู่ตามลำดับ: องค์ประกอบของเลขที่อยู่มักจะเป็นไปตามรูปแบบที่เริ่มต้นด้วยหมายเลขอาคารหรือบ้าน แล้วตามด้วยองค์ประกอบที่มีทิศทางส่วนหน้า ชื่อถนน ประเภทถนนหรือคำต่อท้าย องค์ประกอบที่มีทิศทางส่วนหลัง ชื่ออพาร์ตเมนต์ หมายเลขอพาร์ตเมนต์ และ/หรือชื่อและหมายเลขกล่องจดหมายส่วนตัว
- ใช้ตัวย่อที่ถูกต้อง: บริการไปรษณีย์ของสหรัฐฯ และไปรษณีย์ของแคนาดามีตัวย่อที่เป็นมาตรฐานสำหรับรัฐ/จังหวัด คำต่อท้ายถนน และการตั้งชื่ออพาร์ตเมนต์หรือหน่วยงาน
- อักษรย่อที่ไม่มีมาตรฐานอาจจะทำให้ได้ผลลัพธ์การค้นหาไม่ดี
- ถ้าคุณไม่แน่ใจเกี่ยวกับตัวย่อ ก็อย่านำมาใช้
ตัวอย่างเช่น
- หมายเลขอาคารหรือบ้าน - 1, 1A, หนึ่ง
- ชื่อถนน - Main, George Washington, เลขที่ 42
- คำต่อท้ายถนน - ถนน, Avenue, ถ., Ave
- ป้อนเมือง รัฐ/จังหวัด และรหัสไปรษณีย์: การให้ข้อมูลครบทั้งสามส่วนจะเพิ่มความแม่นยำของผลลัพธ์ของคุณ ไม่จำเป็นต้องใช้ส่วน ZIP+4 ของรหัสไปรษณีย์สำหรับการตรวจสอบที่อยู่
- ใช้ตัวย่อที่ถูกต้อง: บริการไปรษณีย์ของสหรัฐฯ และไปรษณีย์ของแคนาดามีตัวย่อที่เป็นมาตรฐานสำหรับรัฐ/จังหวัด คำต่อท้ายถนน และการตั้งชื่ออพาร์ตเมนต์หรือหน่วยงาน อักษรย่อที่ไม่มีมาตรฐานอาจจะทำให้ได้ผลลัพธ์การค้นหาไม่ดี ถ้าคุณไม่แน่ใจเกี่ยวกับตัวย่อ ก็อย่านำมาใช้
- พิจารณาถึงการให้ข้อคิดเห็นของการตรวจสอบที่อยู่กับผู้ใช้เพื่อให้พวกเขามีตัวเลือกให้เลือกที่อยู่ที่ถูกต้องที่สุดสำหรับพวกเขา
กฎการดำเนินธุรกิจ
- หมายเหตุ: ห้ามใช้ API นี้เพื่อพิจารณาความพร้อมของการจัดส่งพัสดุของที่อยู่ FedEx ไม่มีบริการจัดส่งไปยังที่อยู่ที่ถูกต้องได้ครบทุกแห่ง FedEx ไม่มีบริการจัดส่งไปยังตู้ไปรษณีย์ฝากเช่า (ยกเว้นการจัดส่งผ่าน FedEx Ground® Economy (เดิมเรียกว่า FedEx SmartPost®)
- ข้อมูลที่ส่งกลับโดยที่อยู่ที่แก้ปัญหาแล้วเป็นข้อมูลสำหรับการแนะนำเท่านั้น
- สามารถตรวจสอบได้สูงสุด 100 ที่อยู่ต่อหนึ่งคำขอ
- พื้นที่ขั้นต่ำแตกต่างกันไปในแต่ละประเทศ
ตัวอย่าง สำหรับที่อยู่ของสหรัฐฯ จำเป็นต้องมีอย่างน้อยหนึ่งบรรทัดที่อยู่และมีรหัสไปรษณีย์หรือเมืองและรหัสรัฐ แต่สำหรับที่อยู่ของ AUS (รูปแบบที่อยู่ของออสเตรเลีย) อาจจะเว้นรหัสรัฐไว้ได้โดยไม่ต้องมีรหัสไปรษณีย์
- ผลลัพธ์การแก้ปัญหาของที่อยู่จะแตกต่างกันไปในแต่ละประเทศ/เขตปกครอง
หมายเหตุ: API การยืนยันที่อาจจะไม่สามารถใช้ได้ในทุกประเทศ โปรดดูที่ ประเทศ/ตำแหน่งที่รองรับ API การตรวจสอบที่อยู่
คอลเล็กชัน JSON API
Response