คู่มือศึกษาการใช้งานการจำลองเสมือนระบบแซนด์บ็อกซ์ API สำหรับลูกค้า
การจำลองเสมือนระบบแซนด์บ็อกซ์คืออะไร
การจำลองเสมือนระบบแซนด์บ็อกซ์ API คือบริการที่จำลองพฤติกรรมของอินสแตนซ์ในแซนด์บ็อกซ์แบบเรียลไทม์ บริการเสมือนจริงของเราจะกำหนดการตอบกลับที่คุณได้รับไว้ล่วงหน้าอย่างสม่ำเสมอ และไม่แปรผันตามค่าอินพุตเฉพาะที่คุณระบุเสมอไป
ตัวอย่างเช่น สมมติว่าคุณโทรหลายครั้งด้วยคำขออัตราเดิม โดยเปลี่ยนสถานที่ของผู้ส่งและผู้รับในการทดสอบแต่ละครั้ง API จะส่งคืนการตอบกลับตามอัตราที่กำหนดไว้ล่วงหน้าเหมือนเดิม ไม่ว่าที่อยู่จะเปลี่ยนแปลงหรือไม่ แม้ว่าค่าอาจไม่ตรงกัน แต่โครงสร้างการตอบกลับจะจำลองสิ่งที่คุณอาจได้รับในระบบใช้งานจริง
เนื่องจากบริการเสมือนจริงไม่กระทบกับระบบส่วนหลังที่ใช้งานจริง การทดสอบการผสานรวมระบบของคุณจึงได้รับการปกป้องจากระบบส่วนหลังในขณะที่คุณยังคงได้รับการตอบสนองที่เหมาะสม
เหตุใดแซนด์บ็อกซ์ FedEx ถึงต้องมีการจำลองเสมือนจริง
ในระบบที่มีความซับซ้อนและพึ่งพาซึ่งกันและกันอย่าง FedEx นั้น มีบางกรณีที่ทรัพยากรที่จำเป็นต้องใช้งานไม่พร้อมใช้งานและความพร้อมใช้งานของระบบลดลง เมื่อเกิดเหตุการณ์ดังกล่าวขึ้น ถึงแม้จะอยู่ห่างไกล แต่ก็อาจส่งผลเสียต่อการทดสอบการผสานรวม API ของคุณได้ และยังมีข้อจำกัดอื่นๆ ในอินสแตนซ์แบบเรียลไทม์ซึ่งอาจจำกัดขอบเขตการทดสอบการผสานรวมของคุณไปด้วย ตัวอย่างเช่น
- บัญชีการจัดส่งไม่มีสิทธิ์เข้าถึงเพื่อทำการทดสอบสถานการณ์เฉพาะบางสถานการณ์
- ความพร้อมใช้งานของข้อมูลการทดสอบมีจำกัด
- การหยุดทำงานของระบบที่วางแผนไว้หรือไม่ได้วางแผนไว้
คุณจะใช้อินสแตนซ์ในระบบแซนด์บ็อกซ์เสมือนจริงได้อย่างไร
- ทำความเข้าใจด้วยตนเองกับเอกสารประกอบ API ปลายทาง และวิธีการยืนยันตัวตน ซึ่งจะช่วยในการออกแบบการทดสอบที่มีประสิทธิภาพ
- ดาวน์โหลดและทำความเข้าใจด้วยตนเองกับคอลเล็กชัน JSON API ที่ระบุไว้ในเอกสารประกอบ API
- เลือกและทดสอบธุรกรรมตัวอย่างที่เหมาะกับสถานการณ์การใช้งานของคุณ เพื่อประสบการณ์ที่ต่อเนื่อง ขอให้หลีกเลี่ยงการเปลี่ยนโครงสร้างเพย์โหลดคำขอเพื่อให้คุณได้รับการตอบกลับแบบเสมือนจริง
- โปรดทราบว่าค่าอินพุตบางค่าอาจไม่ส่งผลต่อการตอบสนอง ควรมุ่งเน้นไปที่การทำความเข้าใจวิธีที่แอปพลิเคชันของคุณจัดการกับการตอบสนองที่สอดคล้องกันแทน
- ทดสอบ API ทั้งหมดเพื่อดูการทำงานที่ถูกต้องตามเอกสารประกอบ รวมถึงกรณีทดสอบทั้งเชิงบวกและเชิงลบ
- ใช้กรณีทดสอบเชิงลบที่ระบุไว้เพื่อทำความเข้าใจวิธีส่งคืนข้อความแสดงข้อผิดพลาดและรหัสสถานะ ซึ่งจะช่วยในการพิจารณาว่าแอปพลิเคชันของคุณควรจัดการข้อผิดพลาดอย่างไร โปรดดูที่คอลเล็กชัน JSON API และกรณีทดสอบที่เพิ่มคำนำหน้าเป็น "เชิงลบ"
ประโยชน์ของบริการจำลองเสมือน
- มีโอกาสน้อยลงที่ทรัพยากรจะไม่พร้อมใช้งาน
- พึ่งพาข้อมูลทดสอบน้อยลง
- มีการตอบสนองเร็วขึ้นเมื่อเทียบกับอินสแตนซ์ในระบบแซนด์บ็อกซ์แบบเรียลไทม์
- ไม่ต้องเข้าถึงระดับบัญชีอย่างชัดเจนสำหรับบริการพิเศษ
- การผสานรวมระบบเป็นไปอย่างราบรื่น ทำให้กระบวนการทดสอบและการรับรองสะดวกขึ้น
คำถามที่พบบ่อย
- ฉันจะได้รับเพย์โหลดคำขอเพื่อตอบรับการตอบสนองแบบเสมือนจริงได้อย่างไร
เอกสารประกอบ API แต่ละฉบับมีคอลเล็กชัน JSON API จัดเตรียมไว้ให้ ไปที่แคตตาล็อก API และเปิดเอกสารประกอบ API ดูที่ส่วน "คอลเล็กชัน JSON API" ในเอกสารประกอบ API คอลเล็กชัน JSON API นี้มีเพย์โหลดคำขอทั้งหมดบันทึกไว้ซึ่งจะดึงข้อมูลการตอบสนองแบบเสมือนจริง - ฉันจำเป็นต้องใช้โทเค็นเพื่อเข้าถึงอินสแตนซ์ในระบบแซนด์บ็อกซ์แบบเสมือนจริงหรือไม่
ใช่ การสร้างโทเค็นและการให้สิทธิ์อนุญาตจะทำงานเหมือนเดิม และคุณจะต้องส่งโทเค็นสำหรับทุกธุรกรรมที่โต้ตอบกับบริการแซนด์บ็อกซ์แบบเสมือนจริง - ฉันจะรู้ได้อย่างไรว่ามีการส่งคืนการตอบสนองจากบริการเสมือนจริง
การตอบสนองแบบเสมือนจริงจะเพิ่มการแจ้งเตือนด้านล่างเป็นส่วนหนึ่งของเพย์โหลด
- ใน API สำหรับอัตราค่าบริการและเวลาในการส่ง เหตุใดที่อยู่ของฉันในเพย์โหลดคำขอจึงไม่ได้รับการตรวจสอบ
การตรวจสอบที่อยู่ไม่ได้เป็นส่วนหนึ่งของตรรกะที่ได้มาจากการตอบสนองอัตราเสมือนจริง เฉพาะประเทศเท่านั้นที่ได้รับการตรวจสอบ คุณจึงสามารถส่งค่าใดก็ได้ในช่องที่อยู่ที่เหลือ - API ทั้งหมดเป็นแบบเสมือนจริงหรือไม่
จนถึงปัจจุบัน มีเพียง API ต่อไปนี้เท่านั้นที่ได้รับการจำลองเสมือนจริง ซึ่งอยู่ระหว่างดำเนินการเพื่อทำให้ความสามารถ API ที่เหลือเป็นแบบเสมือนจริง
API สำหรับอัตราค่าบริการและเวลาในการส่ง | เสมือนจริง |
API สำหรับการติดตาม | เสมือนจริง |
Freight LTL API – ความสามารถด้านอัตราและการรับพัสดุ | เสมือนจริง |
API สำหรับการตรวจสอบที่อยู่ | เสมือนจริง |
API สำหรับการตรวจสอบรหัสไปรษณีย์ | เสมือนจริง |
API สำหรับคำขอรับพัสดุ | เสมือนจริง |
API สำหรับความพร้อมในการให้บริการ | เสมือนจริง |
Global Trade API | เสมือนจริง |
API สำหรับการปิดรายการเมื่อสิ้นสุดวันสำหรับการจัดส่งภาคพื้นดิน | เสมือนจริง |
Open Ship API | เสมือนจริง |
API สำหรับการจัดส่ง | เสมือนจริง |
API สำหรับการค้นหาศูนย์บริการ FedEx | เสมือนจริง |