Skip to main content
หน้าหลักบล็อกคู่มือการทดสอบการผสานรวม Tracking API ในสภาพแวดล้อมการพัฒนา: Sandbox, หมายเลขทดสอบ, Webhook จำลอง

การทดสอบการผสานรวม Tracking API ในสภาพแวดล้อมการพัฒนา: Sandbox, หมายเลขทดสอบ, Webhook จำลอง

17TRACK

ในการทดสอบการผสานรวม tracking API ในสภาพแวดล้อมการพัฒนา ให้ใช้สามวิธีเสริมกัน ได้แก่ sandbox ของผู้ให้บริการหรือหมายเลขทดสอบที่มีเอกสารระบุไว้เพื่อทดสอบพฤติกรรมของ API, fixtures ภายในเครื่องสำหรับสถานการณ์การจัดส่งที่ทำซ้ำได้ และ mock webhooks สำหรับปลายทางที่รับข้อมูลของคุณ จากนั้นดำเนินการตรวจสอบแบบ live ที่มีการควบคุม เพื่อยืนยันส่วนที่การจำลองไม่สามารถพิสูจน์ได้ ซึ่งรวมถึงข้อมูลรับรอง การกำหนดค่าการสมัครใช้งาน และการส่ง event จริง

การทดสอบการผสานรวม Tracking API ใน Development Sandbox และหมายเลขทดสอบ

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

แยกพฤติกรรมของผู้ให้บริการออกจากพฤติกรรมของแอปพลิเคชัน

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

วางแผนการทดสอบโดยยึดตามขอบเขตเหล่านี้ แทนที่จะคาดหวังว่าหมายเลขทดสอบการติดตามเพียงหมายเลขเดียวจะทดสอบทั้งระบบ

วิธีทดสอบสิ่งที่สามารถตรวจสอบได้สิ่งที่ไม่สามารถยืนยันได้เพียงลำพัง
Provider sandboxรูปแบบคำขอที่รองรับ การยืนยันตัวตน และพฤติกรรมจำลองที่ผู้ให้บริการระบุไว้ความพร้อมใช้งานของข้อมูลผู้ขนส่งในระบบจริง หรือพฤติกรรมการส่งข้อมูลในระบบจริง
หมายเลขทดสอบที่มีเอกสารระบุไว้สถานการณ์เฉพาะที่กำหนดให้กับหมายเลขเหล่านั้นสถานะ ผู้ขนส่ง หรือ webhook sequence อื่น ๆ
Fixtures ภายในเครื่องและ API mocksparser, กฎการแมป, การจัดเก็บข้อมูล และการจัดการข้อผิดพลาดของคุณผู้ให้บริการจริงจะยอมรับคำขอหรือส่ง payload แบบเดียวกันหรือไม่
คำขอ mock webhookการจัดการปลายทาง การตรวจสอบความถูกต้อง การตัดข้อมูลซ้ำ และผลกระทบต่อระบบปลายทางการกำหนดค่า callback ฝั่งผู้ให้บริการ หรือการส่งซ้ำจริง
การทดสอบ live แบบควบคุมการเชื่อมต่อจริงและเวิร์กโฟลว์การจัดส่งที่สังเกตได้ข้อผิดพลาด ข้อยกเว้น หรือ sequence การส่งข้อมูลที่เกิดขึ้นได้ยากทั้งหมด

แนวทางที่แนะนำ: ทำให้การทดสอบภายในเครื่องมีผลลัพธ์ที่กำหนดแน่นอน ใช้การทดสอบที่ผู้ให้บริการรองรับเมื่อมีให้ใช้งาน และสงวนการจัดส่งจริงไว้เพื่อยืนยันการเชื่อมต่อระหว่างระบบ

ยืนยันสัญญาของผู้ให้บริการก่อนสร้าง fixtures

เริ่มจากเอกสารอย่างเป็นทางการสำหรับ API version ที่คุณตั้งใจจะใช้ ยืนยัน base URL, วิธีการยืนยันตัวตน ข้อกำหนดการลงทะเบียน response schema การตั้งค่า webhook และสิ่งอำนวยความสะดวกด้านการทดสอบที่มีเอกสารระบุไว้ อย่าสันนิษฐานว่ามี sandbox แยกต่างหากเพียงเพราะผู้ให้บริการมี API

สำหรับการผสานรวม 17TRACK ให้ใช้ หน้าติดตาม 17TRACK API และ เอกสาร API อย่างเป็นทางการ เป็นจุดเริ่มต้น ตรวจสอบข้อกำหนดของคำขอและ callback ที่เกี่ยวข้องจากแหล่งข้อมูลดังกล่าวก่อนสร้างตัวอย่างเฉพาะผู้ให้บริการ ตัวอย่างด้านล่างเป็น fixtures ที่แอปพลิเคชันเป็นเจ้าของโดยเจตนา ไม่ใช่ตัวแทนของ 17TRACK API schema

ตอบคำถามต่อไปนี้ก่อนเชื่อมต่อโค้ดการพัฒนาเข้ากับบัญชีภายนอก:

  • ข้อมูลรับรองสำหรับการพัฒนาและการใช้งานจริงแยกกันหรือไม่ และข้อมูลรับรองแต่ละชุดเข้าถึงสภาพแวดล้อมใด
  • sandbox รองรับ callback หรือรองรับเฉพาะการทดสอบแบบ request-response
  • มีการระบุหมายเลขทดสอบไว้หรือไม่ และหมายเลขเหล่านั้นให้ผลลัพธ์ที่แน่นอนอย่างไร
  • การลงทะเบียนหรือคำขอทดสอบอื่น ๆ ใช้โควตาบัญชีหรือสร้างระเบียนถาวรหรือไม่
  • มีการระบุข้อกำหนดด้านการยืนยันตัวตนของ callback การตอบรับ timeout และการส่งซ้ำไว้อย่างไร
  • ตัวระบุใดเชื่อมโยงการลงทะเบียนการติดตาม การจัดส่ง ผู้ขนส่ง และ callback event เข้าด้วยกัน

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

สร้างสภาพแวดล้อมการพัฒนาที่แยกเป็นอิสระ

ใช้ฐานข้อมูลแยกหรือ tenant ที่แยกออกจากกัน ใช้ secrets แยกต่างหาก และใช้คำสั่งซื้อสังเคราะห์ กำหนดเส้นทางอีเมล ข้อความ SMS และการแจ้งเตือนอื่น ๆ ไปยังปลายทางทดสอบหรือ notification sink การจัดส่งที่ถูกทำเครื่องหมายว่าส่งแล้วใน fixture ต้องไม่ทำให้เกิดข้อความถึงผู้ซื้อจริง

เพิ่มเครื่องหมายสภาพแวดล้อมที่ชัดเจนลงในระเบียนภายในและ log เก็บข้อมูลรับรองของผู้ให้บริการไว้บนเซิร์ฟเวอร์ นอก source control และปกปิด secrets จาก request captures หากจำเป็นต้องเปิดการเข้าถึงสาธารณะชั่วคราวสำหรับ callback ให้เปิดเผยเฉพาะ route การพัฒนาที่ต้องการ และคงการควบคุมการยืนยันตัวตนไว้

สร้างคำสั่งซื้อที่ทราบข้อมูลล่วงหน้าจำนวนเล็กน้อยก่อนส่ง event รวมการจัดส่งสองรายการที่ผูกกับคำสั่งซื้อเดียวกัน และหากแอปพลิเคชันของคุณรองรับ ให้ใช้ tracking-number string เดียวกันภายใต้บริบทของผู้ขนส่งที่แตกต่างกัน กรณีเหล่านี้ช่วยเปิดเผยสมมติฐานที่ว่าหมายเลขติดตามเพียงอย่างเดียวจะระบุระเบียนทางธุรกิจที่ไม่ซ้ำกันได้เสมอ

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

ใช้หมายเลขทดสอบเฉพาะตามวัตถุประสงค์ที่มีเอกสารระบุไว้

หมายเลขติดตามมีบทบาทในการทดสอบที่แตกต่างกันสองแบบ อาจเป็น input ที่ใช้ตรวจสอบการลงทะเบียน และอาจใช้ระบุการจัดส่งที่สร้าง tracking events ได้ หมายเลขที่ผ่านการตรวจสอบรูปแบบไม่ได้หมายความว่าจะมีประวัติ event ที่เป็นประโยชน์

เมื่อมีหมายเลขทดสอบอย่างเป็นทางการ

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

เก็บหมายเลขเหล่านี้ไว้ในการกำหนดค่า integration-test โดยเฉพาะ อย่ากระจายหมายเลขเหล่านี้ไว้ใน unit tests เพราะการเปลี่ยนแปลงพฤติกรรมภายนอกอาจทำให้การทดสอบที่ควรมีผลลัพธ์แน่นอนไม่น่าเชื่อถือ

เมื่อยังไม่ยืนยันหมายเลขทดสอบอย่างเป็นทางการ

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

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

การจัดส่งเก่าที่ส่งสำเร็จแล้วอาจช่วยตรวจสอบ parsing ได้ แต่เป็น dependency ที่ไม่ดีสำหรับ continuous integration ความพร้อมใช้งานของข้อมูลย้อนหลังและ response ภายนอกอาจเปลี่ยนแปลงได้ ให้เก็บ fixture ที่ลบข้อมูลสำคัญแล้วไว้สำหรับการทดสอบซ้ำ และแยกการตรวจสอบแบบ live ออกต่างหาก

สร้าง fixtures ตามการเปลี่ยนผ่านของการจัดส่งที่มีความหมาย

สร้าง fixtures จาก schema ที่มีเอกสารระบุไว้ และเมื่อมีข้อมูล ให้ใช้ response จริงที่ลบข้อมูลสำคัญแล้ว แยก provider payload fixtures ออกจาก internal normalized event model ทดสอบ adapter ระหว่างทั้งสองส่วน เพื่อไม่ให้ internal mock ซ่อน parser ของผู้ให้บริการที่เสียหาย

ชุดเริ่มต้นที่มีประโยชน์ควรครอบคลุมสถานการณ์เหล่านี้:

  • ยังไม่มี tracking events: เก็บการจัดส่งไว้โดยไม่อ้างว่ามีการเคลื่อนย้ายหรือจัดส่งแล้ว
  • อยู่ระหว่างการขนส่ง: อัปเดตไทม์ไลน์และรักษาความสัมพันธ์กับคำสั่งซื้อที่ถูกต้อง
  • กำลังนำจ่าย: ใช้นโยบายการแจ้งเตือนของคุณโดยไม่ถือว่าการจัดส่งเสร็จสมบูรณ์
  • จัดส่งแล้ว: บันทึกการเสร็จสิ้นและสร้าง business action ที่ต้องการเพียงครั้งเดียว
  • ข้อยกเว้นหรือพยายามจัดส่ง: รักษาความแตกต่างจากการจัดส่งที่เสร็จสมบูรณ์
  • การเคลื่อนย้ายเพื่อส่งคืน: อย่าตีความทุก scan ในภายหลังว่าเป็นความคืบหน้าไปยังผู้รับเดิม
  • สถานะไม่ทราบ: เก็บข้อมูลไว้เพียงพอสำหรับการวินิจฉัย โดยไม่สร้าง status mapping ขึ้นเอง

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

นอกจากนี้ ให้เปลี่ยนรูปแบบของข้อมูลด้วย เช่น รายการ event ว่าง ฟิลด์เสริมที่หายไป ฟิลด์ที่ไม่รู้จักเพิ่มเติม ชื่อสถานที่ใน Unicode timestamp ที่มี timezone offsets และค่าที่จำเป็นซึ่งมีรูปแบบไม่ถูกต้อง parser ของคุณควรยอมรับส่วนเพิ่มเติมที่เข้ากันได้ ขณะเดียวกันต้องปฏิเสธข้อมูลที่ไม่สามารถประมวลผลได้อย่างปลอดภัย

ส่ง mock webhooks ผ่านเส้นทางรับข้อมูลจริง

mock webhook ควรทดสอบ receiving route, authentication middleware, validation, storage และ worker processing ไม่ใช่เพียงเรียกฟังก์ชันอัปเดตสถานะสุดท้าย

payload ต่อไปนี้แสดง internal event แบบสังเคราะห์ ชื่อฟิลด์ event ID และ status เป็นเพียงตัวอย่าง ไม่ใช่สัญญา callback ของผู้ให้บริการ

{
  "event_id": "dev-event-001",
  "shipment_id": "dev-shipment-001",
  "tracking_number": "INTERNAL-TEST-001",
  "status": "in_transit",
  "occurred_at": "2025-01-15T10:00:00Z"
}

บันทึกเป็น tracking-event.json แล้วส่งไปยังตัวรับการทดสอบภายในเครื่อง:

curl --request POST \
  http://localhost:3000/dev/tracking-events \
  --header 'Content-Type: application/json' \
  --data-binary @tracking-event.json

คำสั่งนี้ตรวจสอบเฉพาะ routing และการจัดการภายในเครื่อง ไม่ได้แสดงการยืนยันตัวตนของผู้ให้บริการ ให้ route ที่ใช้เฉพาะการพัฒนาไม่สามารถเข้าถึงได้ในระบบจริง หรือทดสอบตัวรับข้อมูลจริงโดยใช้วิธีการยืนยันตัวตนที่ผู้ให้บริการระบุไว้และ test secret แยกต่างหาก

ทดสอบการยืนยันตัวตนโดยไม่ลดทอนการควบคุมในระบบจริง

หากผู้ให้บริการระบุ callback ที่มีลายเซ็น ให้ใช้ scheme ดังกล่าวอย่างถูกต้อง แทนการเลือก signature header หรือ algorithm ตามอำเภอใจ สำหรับ scheme ที่เซ็น request bytes ให้เก็บ body เดิมไว้เพื่อตรวจสอบ เพราะการ parse และ serialize JSON ใหม่อาจเปลี่ยน bytes เหล่านั้น

ทดสอบการยืนยันตัวตนที่ถูกต้อง ข้อมูลรับรองที่หายไป body ที่ถูกแก้ไข และลายเซ็นที่ไม่ถูกต้องเมื่อเกี่ยวข้อง หาก scheme ที่มีเอกสารระบุไว้รวม timestamp หรือการป้องกัน replay ให้ทดสอบกฎเหล่านั้นด้วย HMAC เป็นโครงสร้างการยืนยันตัวตนของข้อความที่มีมาตรฐาน แต่การมีอยู่ของ HMAC ไม่ได้ยืนยันว่าผู้ให้บริการติดตามรายใดรายหนึ่งใช้ HMAC

ทดสอบข้อมูลซ้ำ ลำดับ และการกู้คืน

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

การทดสอบพฤติกรรมที่คาดหวังของแอปพลิเคชัน
ส่ง event เดิมสองครั้งเก็บเป็น event เชิงตรรกะเพียงรายการเดียวและหลีกเลี่ยงการแจ้งเตือนลูกค้าซ้ำ
ส่ง transit scan ที่เก่ากว่าหลังจัดส่งแล้วเก็บประวัติที่มีประโยชน์ไว้โดยไม่ย้อนสถานะที่จัดส่งแล้วโดยอัตโนมัติ
ส่งการอัปเดตพร้อมกันใช้การเปลี่ยนสถานะที่สอดคล้องกันแม้มี worker ทำงานพร้อมกัน
หยุดประมวลผลหลังรับข้อมูลอย่างถาวรกู้คืนและประมวลผล event ที่จัดเก็บไว้โดยไม่ต้องรอ callback ใหม่
การจัดเก็บล้มเหลวก่อนการรับข้อมูลจะถาวรอย่าตอบรับการรับข้อมูลสำเร็จอย่างไม่ถูกต้อง
ส่งการจัดส่งที่ไม่รู้จักปฏิบัติตามนโยบายกักกันหรือปฏิเสธที่กำหนดไว้ ห้ามเดาความสัมพันธ์กับคำสั่งซื้อ

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

แยกประวัติ event ออกจาก projection ปัจจุบันของการจัดส่ง การเก็บ scan ในอดีตไม่ได้หมายความว่าต้องอนุญาตให้ scan ที่มาถึงล่าช้าทุกรายการเขียนทับสถานะที่แสดงอยู่ และ “ใช้ timestamp ล่าสุด” ก็ไม่ใช่กฎที่สมบูรณ์ การแก้ไข กระบวนการส่งคืน และความหมายของ timestamp ที่แตกต่างกันต้องได้รับการจัดการอย่างชัดเจน

สำหรับการประมวลผลแบบ asynchronous ให้ตอบรับหลังจาก event ไปถึงจุดส่งต่อที่ถาวรแล้วเท่านั้น เช่น committed inbox record หรือ durable queue ตามสถาปัตยกรรมของคุณ ปฏิบัติตามข้อกำหนดการตอบรับที่ผู้ให้บริการระบุไว้ HTTP กำหนดความหมายของ status code แต่กำหนดการส่งซ้ำของผู้ส่งรายใดต้องอ้างอิงจากสัญญาของผู้ส่งรายนั้นเอง

ดำเนินการตรวจสอบแบบ live ที่มีการควบคุมและกำหนดเกณฑ์การเผยแพร่

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

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

ก่อนเผยแพร่ ให้กำหนดผลลัพธ์ต่อไปนี้เป็นข้อบังคับ:

  • จัดการ response สำเร็จและข้อผิดพลาดที่มีเอกสารระบุไว้ รวมถึงความล้มเหลวระดับรายการหาก API รองรับการดำเนินการแบบ batch
  • Timeout ต้องไม่ทำให้เกิดการ retry เพื่อสร้างข้อมูลใหม่โดยไม่ตรวจสอบ หากคำขอแรกอาจสำเร็จไปแล้ว
  • event ซ้ำต้องไม่สร้าง business action ซ้ำ
  • callback ที่ไม่ถูกต้องต้องไม่เปลี่ยนสถานะการจัดส่ง
  • ความล้มเหลวของ worker ต้องทิ้ง event ที่กู้คืนได้ แทนที่จะสูญหายไปโดยไม่มีการแจ้งเตือน
  • ทราฟฟิกการพัฒนาต้องไม่แจ้งเตือนลูกค้าจริงหรือเปลี่ยนแปลงคำสั่งซื้อในระบบจริง
  • log ต้องเชื่อมโยงคำขอ event ที่ได้รับ ผลลัพธ์การประมวลผล และความพยายามแจ้งเตือนเข้าด้วยกัน โดยไม่เปิดเผย secrets

การเผยแพร่พร้อมเมื่อคุณสามารถอธิบายทั้งเวิร์กโฟลว์ปกติและวิธีที่ระบบกู้คืนหลังคำขอที่ไม่แน่นอน callback ซ้ำ หรือ worker หยุดทำงาน การค้นหาการติดตามที่สำเร็จเพียงครั้งเดียวไม่เพียงพอ

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

ฉันสามารถทดสอบการผสานรวมการติดตามโดยไม่มี sandbox ได้หรือไม่

ได้ จำลองขอบเขต API ขาออก เล่นซ้ำ callback fixtures ที่มีเอกสารระบุไว้ และทดสอบ normalization กับกฎทางธุรกิจภายในเครื่อง จากนั้นใช้การจัดส่งจริงที่ได้รับอนุญาตเพื่อยืนยันการเชื่อมต่อจริง วิธีนี้ให้ความครอบคลุมอย่างมาก แต่ไม่สามารถจำลองพฤติกรรมของผู้ให้บริการที่ไม่ได้ระบุไว้ในเอกสาร

เหตุใดคำขอติดตามของฉันจึงสำเร็จแต่ไม่มี event

การยอมรับคำขอและความพร้อมใช้งานของข้อมูลการติดตามเป็นผลลัพธ์คนละส่วนกัน ตรวจสอบรายละเอียด response ของผู้ให้บริการ ข้อกำหนดการลงทะเบียน กฎการระบุผู้ขนส่ง และพฤติกรรมที่มีเอกสารระบุไว้สำหรับการจัดส่งที่ยังไม่มี event อย่าสร้างข้อมูลการเคลื่อนย้ายหรือการจัดส่งขึ้นเองเพื่อเติมไทม์ไลน์ที่ว่างเปล่า

mock webhook ที่สำเร็จพิสูจน์ว่า webhook จริงจะมาถึงหรือไม่

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

ฉันควรส่ง HTTP 200 ก่อนการประมวลผลเสร็จหรือไม่

ปฏิบัติตามสัญญาการตอบรับที่ผู้ให้บริการระบุไว้ ในการออกแบบแบบ asynchronous ให้ตอบรับหลังการยอมรับข้อมูลอย่างถาวร จากนั้นประมวลผลใน worker การตอบกลับสำเร็จก่อนการยอมรับอย่างถาวรอาจทำให้ event สูญหายหาก process ล้มเหลวทันทีหลังจากนั้น

ฉันควรทดสอบการแจ้งเตือนลูกค้าอย่างไร

ส่งการแจ้งเตือนทั้งหมดในระหว่างการพัฒนาไปยัง sink ที่ควบคุมได้ ตรวจสอบปลายทาง template การเปลี่ยนผ่านที่เป็นตัวกระตุ้น และจำนวนครั้งที่ส่ง เล่นซ้ำ event เดิมและจำลองการ retry ของ worker เพื่อยืนยันว่าการอัปเดตการจัดส่งหนึ่งรายการไม่สร้างข้อความถึงลูกค้าซ้ำ

แหล่งข้อมูล

  • 17TRACK Tracking API — จุดเริ่มต้นอย่างเป็นทางการสำหรับผลิตภัณฑ์ tracking API
  • เอกสาร 17TRACK API — แหล่งอ้างอิงสำหรับสัญญาการผสานรวมเฉพาะผู้ให้บริการ ให้ยืนยันข้อกำหนดด้านการทดสอบและ callback ที่เกี่ยวข้องจากที่นี่
  • RFC 9110: HTTP Semantics — ความหมายของ HTTP response และข้อควรพิจารณาในการส่งคำขอซ้ำ
  • RFC 2104: HMAC — โครงสร้างการยืนยันตัวตนของข้อความที่มีมาตรฐานซึ่งกล่าวถึงในคำแนะนำด้านความปลอดภัยของ callback