คู่มือศึกษาการใช้งานการจำลองเสมือนระบบแซนด์บ็อกซ์ API สำหรับลูกค้า

การจำลองเสมือนระบบแซนด์บ็อกซ์คืออะไร

การจำลองเสมือนระบบแซนด์บ็อกซ์ API คือบริการที่จำลองพฤติกรรมของอินสแตนซ์ในแซนด์บ็อกซ์แบบเรียลไทม์ บริการเสมือนจริงของเราจะกำหนดการตอบกลับที่คุณได้รับไว้ล่วงหน้าอย่างสม่ำเสมอ และไม่แปรผันตามค่าอินพุตเฉพาะที่คุณระบุเสมอไป

ตัวอย่างเช่น สมมติว่าคุณโทรหลายครั้งด้วยคำขออัตราเดิม โดยเปลี่ยนสถานที่ของผู้ส่งและผู้รับในการทดสอบแต่ละครั้ง API จะส่งคืนการตอบกลับตามอัตราที่กำหนดไว้ล่วงหน้าเหมือนเดิม ไม่ว่าที่อยู่จะเปลี่ยนแปลงหรือไม่ แม้ว่าค่าอาจไม่ตรงกัน แต่โครงสร้างการตอบกลับจะจำลองสิ่งที่คุณอาจได้รับในระบบใช้งานจริง

เนื่องจากบริการเสมือนจริงไม่กระทบกับระบบส่วนหลังที่ใช้งานจริง การทดสอบการผสานรวมระบบของคุณจึงได้รับการปกป้องจากระบบส่วนหลังในขณะที่คุณยังคงได้รับการตอบสนองที่เหมาะสม

เหตุใดแซนด์บ็อกซ์ FedEx ถึงต้องมีการจำลองเสมือนจริง

ในระบบที่มีความซับซ้อนและพึ่งพาซึ่งกันและกันอย่าง FedEx นั้น มีบางกรณีที่ทรัพยากรที่จำเป็นต้องใช้งานไม่พร้อมใช้งานและความพร้อมใช้งานของระบบลดลง เมื่อเกิดเหตุการณ์ดังกล่าวขึ้น ถึงแม้จะอยู่ห่างไกล แต่ก็อาจส่งผลเสียต่อการทดสอบการผสานรวม API ของคุณได้ และยังมีข้อจำกัดอื่นๆ ในอินสแตนซ์แบบเรียลไทม์ซึ่งอาจจำกัดขอบเขตการทดสอบการผสานรวมของคุณไปด้วย ตัวอย่างเช่น

  • บัญชีการจัดส่งไม่มีสิทธิ์เข้าถึงเพื่อทำการทดสอบสถานการณ์เฉพาะบางสถานการณ์
  • ความพร้อมใช้งานของข้อมูลการทดสอบมีจำกัด
  • การหยุดทำงานของระบบที่วางแผนไว้หรือไม่ได้วางแผนไว้

คุณจะใช้อินสแตนซ์ในระบบแซนด์บ็อกซ์เสมือนจริงได้อย่างไร

  • ทำความเข้าใจด้วยตนเองกับเอกสารประกอบ API ปลายทาง และวิธีการยืนยันตัวตน ซึ่งจะช่วยในการออกแบบการทดสอบที่มีประสิทธิภาพ
  • ดาวน์โหลดและทำความเข้าใจด้วยตนเองกับคอลเล็กชัน JSON API ที่ระบุไว้ในเอกสารประกอบ API
  • เลือกและทดสอบธุรกรรมตัวอย่างที่เหมาะกับสถานการณ์การใช้งานของคุณ เพื่อประสบการณ์ที่ต่อเนื่อง ขอให้หลีกเลี่ยงการเปลี่ยนโครงสร้างเพย์โหลดคำขอเพื่อให้คุณได้รับการตอบกลับแบบเสมือนจริง
  • โปรดทราบว่าค่าอินพุตบางค่าอาจไม่ส่งผลต่อการตอบสนอง ควรมุ่งเน้นไปที่การทำความเข้าใจวิธีที่แอปพลิเคชันของคุณจัดการกับการตอบสนองที่สอดคล้องกันแทน
  • ทดสอบ API ทั้งหมดเพื่อดูการทำงานที่ถูกต้องตามเอกสารประกอบ รวมถึงกรณีทดสอบทั้งเชิงบวกและเชิงลบ
  • ใช้กรณีทดสอบเชิงลบที่ระบุไว้เพื่อทำความเข้าใจวิธีส่งคืนข้อความแสดงข้อผิดพลาดและรหัสสถานะ ซึ่งจะช่วยในการพิจารณาว่าแอปพลิเคชันของคุณควรจัดการข้อผิดพลาดอย่างไร โปรดดูที่คอลเล็กชัน JSON API และกรณีทดสอบที่เพิ่มคำนำหน้าเป็น "เชิงลบ"

ประโยชน์ของบริการจำลองเสมือน

  • มีโอกาสน้อยลงที่ทรัพยากรจะไม่พร้อมใช้งาน
  • พึ่งพาข้อมูลทดสอบน้อยลง
  • มีการตอบสนองเร็วขึ้นเมื่อเทียบกับอินสแตนซ์ในระบบแซนด์บ็อกซ์แบบเรียลไทม์
  • ไม่ต้องเข้าถึงระดับบัญชีอย่างชัดเจนสำหรับบริการพิเศษ
  • การผสานรวมระบบเป็นไปอย่างราบรื่น ทำให้กระบวนการทดสอบและการรับรองสะดวกขึ้น

คำถามที่พบบ่อย

  1. ฉันจะได้รับเพย์โหลดคำขอเพื่อตอบรับการตอบสนองแบบเสมือนจริงได้อย่างไร
    เอกสารประกอบ API แต่ละฉบับมีคอลเล็กชัน JSON API จัดเตรียมไว้ให้ ไปที่แคตตาล็อก API และเปิดเอกสารประกอบ API ดูที่ส่วน "คอลเล็กชัน JSON API" ในเอกสารประกอบ API คอลเล็กชัน JSON API นี้มีเพย์โหลดคำขอทั้งหมดบันทึกไว้ซึ่งจะดึงข้อมูลการตอบสนองแบบเสมือนจริง
  2. ฉันจำเป็นต้องใช้โทเค็นเพื่อเข้าถึงอินสแตนซ์ในระบบแซนด์บ็อกซ์แบบเสมือนจริงหรือไม่
    ใช่ การสร้างโทเค็นและการให้สิทธิ์อนุญาตจะทำงานเหมือนเดิม และคุณจะต้องส่งโทเค็นสำหรับทุกธุรกรรมที่โต้ตอบกับบริการแซนด์บ็อกซ์แบบเสมือนจริง
  3. ฉันจะรู้ได้อย่างไรว่ามีการส่งคืนการตอบสนองจากบริการเสมือนจริง
    การตอบสนองแบบเสมือนจริงจะเพิ่มการแจ้งเตือนด้านล่างเป็นส่วนหนึ่งของเพย์โหลด

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