Skip to main content
หน้าหลักบล็อกคู่มือข้อผิดพลาดในการตรวจสอบสิทธิ์ของ Tracking API: 7 สาเหตุของการตอบกลับ 401/403 และวิธีแก้ไข

ข้อผิดพลาดในการตรวจสอบสิทธิ์ของ Tracking API: 7 สาเหตุของการตอบกลับ 401/403 และวิธีแก้ไข

17TRACK

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

สาเหตุ 7 ประการของข้อผิดพลาดการยืนยันตัวตน Tracking API ที่ทำให้เกิดการตอบกลับ 401 และ 403

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

ขั้นแรก แยกความแตกต่างระหว่าง 401 กับ 403

คำจำกัดความของ HTTP เป็นจุดเริ่มต้น ไม่ใช่การวินิจฉัยที่สมบูรณ์ 401 Unauthorized หมายความว่าคำขอไม่มีข้อมูลรับรองการยืนยันตัวตนที่ถูกต้องสำหรับทรัพยากรเป้าหมาย ส่วน 403 Forbidden หมายความว่าเซิร์ฟเวอร์เข้าใจคำขอ แต่ปฏิเสธที่จะดำเนินการให้ การตอบกลับ 403 ไม่ได้พิสูจน์เสมอไปว่าการยืนยันตัวตนสำเร็จ เนื่องจากเกตเวย์หรือบริการรักษาความปลอดภัยอาจปฏิเสธคำขอก่อนที่แอปพลิเคชันจะตรวจสอบข้อมูลรับรอง

ตาม RFC 9110 เซิร์ฟเวอร์ที่สร้างการตอบกลับ 401 ต้องมี challenge ของส่วนหัว WWW-Authenticate ให้ตรวจสอบส่วนหัวดังกล่าวเมื่อมีอยู่ แต่ควรอ่านเนื้อหาการตอบกลับและเอกสารข้อผิดพลาดของผู้ให้บริการด้วย เนื่องจากการใช้งานแต่ละแบบอาจแสดงข้อผิดพลาดไม่เหมือนกัน

สิ่งที่สังเกตพบสิ่งที่ควรตรวจสอบก่อน
401 พร้อมข้อความว่าข้อมูลรับรองหายไปหรือไม่ถูกต้องการใส่ข้อมูลรับรอง รูปแบบส่วนหัว และความถูกต้องของข้อมูลรับรอง
403 พร้อมข้อความว่าสิทธิ์ไม่เพียงพอขอบเขตสิทธิ์ การเข้าถึงบัญชี tenant และความเป็นเจ้าของทรัพยากร
403 พร้อมหน้าความปลอดภัย HTMLเกตเวย์ พร็อกซี ไฟร์วอลล์ หรือนโยบายการเข้าถึง
HTTP สำเร็จ แต่มีข้อผิดพลาดอยู่ภายใน JSONฟิลด์ข้อผิดพลาดระดับแอปพลิเคชันของผู้ให้บริการ

แยกสถานะการขนส่งออกจากสถานะแอปพลิเคชันในบันทึกของคุณ ฟิลด์ JSON ที่ชื่อ code ไม่ได้เป็นสถานะ HTTP โดยอัตโนมัติ และการแลกเปลี่ยน HTTP ที่สำเร็จไม่ได้หมายความว่าการดำเนินการติดตามที่ร้องขอสำเร็จเสมอไป

เก็บบันทึกการวินิจฉัยอย่างปลอดภัย

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

บันทึกชื่อส่วนหัวการยืนยันตัวตนและระบุว่ามีค่าหรือไม่ แต่ ห้ามบันทึก API key, bearer token, refresh token หรือ signing secret แบบสมบูรณ์โดยเด็ดขาด หลีกเลี่ยงการส่งออก trace ของคำขอที่ไม่ได้ปกปิดข้อมูล หมายเลขติดตามและรายละเอียดการจัดส่งอาจต้องปกปิดด้วยตามกฎการจัดการข้อมูลขององค์กร

ใช้การดำเนินการที่มีผลกระทบต่ำและมีเอกสารจากผู้ให้บริการเพื่อทำให้ปัญหาเกิดซ้ำ อย่าลงทะเบียนการจัดส่ง สร้างการสมัครสมาชิก หรือเปลี่ยนการตั้งค่า webhook ซ้ำ ๆ เพียงเพื่อทดสอบการยืนยันตัวตน

สาเหตุ 7 ประการของการตอบกลับ 401/403 จาก Tracking API

1. ข้อมูลรับรองไม่เคยไปถึง API

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

พร็อกซียังสามารถลบส่วนหัวการยืนยันตัวตนได้ด้วย ควรให้ความสนใจกับการ redirect เนื่องจากไคลเอนต์ HTTP อาจไม่ส่งต่อส่วนหัวที่มีข้อมูลละเอียดอ่อนไปยังโฮสต์อื่น

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

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

2. รูปแบบการยืนยันตัวตนไม่ถูกต้อง

Tracking API ไม่ได้รองรับรูปแบบการยืนยันตัวตนแบบเดียวกันทั้งหมด ผู้ให้บริการอาจต้องการส่วนหัว API key โดยเฉพาะ bearer token ของ OAuth หรือคำขอที่มีลายเซ็น การใส่คีย์ที่ถูกต้องไว้ใน Authorization: Bearer จะไม่ช่วย หาก endpoint ต้องการส่วนหัวรูปแบบอื่น

ข้อผิดพลาดอื่น ๆ ได้แก่ การคัดลอกเครื่องหมายอัญประกาศเข้าไปในข้อมูลลับ การเพิ่ม prefix ที่ผู้ให้บริการไม่ได้กำหนด การส่งส่วนหัวการยืนยันตัวตนซ้ำ หรือการใช้ฟิลด์การตั้งค่า SDK ที่ใช้กับวิธีการยืนยันตัวตนอื่น

  • ตรวจสอบ: เปรียบเทียบคำขอจริงกับตัวอย่างอย่างเป็นทางการสำหรับ endpoint และเวอร์ชัน API ที่ตรงกัน
  • แก้ไข: ใช้ชื่อส่วนหัว รูปแบบค่า และวิธีการยืนยันตัวตนให้ตรงตามเอกสาร อย่าย้ายข้อมูลลับไปไว้ใน URL เพื่อแก้ปัญหาชั่วคราว
  • ยืนยัน: เปรียบเทียบคำขอขั้นต่ำกับคำขอที่ SDK สร้างขึ้น โดยปกปิดข้อมูลรับรอง

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

3. คีย์ไม่ถูกต้อง ถูกเพิกถอน หรือไม่ได้ปรับใช้ให้สอดคล้องกัน

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

อย่าสันนิษฐานว่า API key ทุกตัวหมดอายุโดยอัตโนมัติ กฎการหมดอายุและการหมุนเวียนขึ้นอยู่กับผู้ให้บริการและประเภทข้อมูลรับรอง

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

หากรองรับ ให้ใช้ตัวระบุข้อมูลรับรองที่ไม่ใช่ข้อมูลลับหรือเวอร์ชันของ secret manager เพื่อแยกแยะการปรับใช้ ห้ามขอให้ลูกค้าหรือเพื่อนร่วมงานวางคีย์แบบเต็มลงใน ticket ฝ่ายสนับสนุน

4. ข้อมูลรับรองและ endpoint อยู่คนละสภาพแวดล้อม

บริการบางรายการแยกข้อมูลรับรอง production และ test, endpoint ตามภูมิภาค บัญชี หรือ tenant ข้อมูลรับรองที่ถูกต้องอาจล้มเหลวเมื่อส่งไปยังโฮสต์หรือบริบทบัญชีที่ไม่ถูกต้อง การตรวจสอบนี้ใช้เฉพาะเมื่อผู้ให้บริการระบุความแตกต่างดังกล่าวไว้ในเอกสาร

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

  • ตรวจสอบ: ตรวจสอบปลายทางทั้งหมด ได้แก่ scheme ชื่อโฮสต์ เวอร์ชัน API เส้นทาง และตัวระบุบัญชีหรือ tenant ที่จำเป็น
  • แก้ไข: จับคู่ข้อมูลรับรองกับสภาพแวดล้อมและ endpoint ที่กำหนด เก็บ URL และการตั้งค่าข้อมูลลับของแต่ละสภาพแวดล้อมไว้ด้วยกัน
  • ยืนยัน: ยืนยันปลายทางที่ถูกแก้ไขแล้วใน deployment ที่กำลังทำงาน และตรวจสอบว่าไคลเอนต์ทำตาม redirect หรือไม่

หลีกเลี่ยงการทดสอบโฮสต์ที่คาดเดาขึ้นมาหลายรายการด้วยข้อมูลรับรองจริง ใช้เฉพาะ endpoint ที่ผู้ให้บริการระบุไว้ในเอกสาร

5. การยืนยันตัวตนสำเร็จ แต่สิทธิ์ไม่เพียงพอ

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

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

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

สำหรับ OAuth bearer token RFC 6750 แยก invalid_token ออกจาก insufficient_scope หากผู้ให้บริการใช้แนวทางนี้ ค่าแรกชี้ไปที่ความถูกต้องของโทเค็น ส่วนค่าหลังชี้ไปที่การอนุญาต อย่าสันนิษฐานว่า Tracking API ทุกตัวใช้ OAuth หรือฟิลด์ข้อผิดพลาดเหล่านี้

6. โทเค็นหมดอายุ หรือลายเซ็นคำขอไม่ถูกต้อง

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

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

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

ในระบบที่มี worker หลายตัว ให้ประสานการรีเฟรชโทเค็นเพื่อไม่ให้ worker เขียนทับข้อมูลรับรองที่ยังใช้งานได้ซ้ำ ๆ หรือเรียกใช้การรีเฟรชพร้อมกันหลายครั้ง เก็บ refresh token แยกจากบันทึกคำขอทั่วไปและป้องกันอย่างเหมาะสม

7. เกตเวย์ ไฟร์วอลล์ หรือนโยบายเครือข่ายบล็อกคำขอ

403 อาจเกิดขึ้นนอกแอปพลิเคชันติดตาม สาเหตุที่เป็นไปได้ ได้แก่ IP allowlist ไม่ตรงกัน นโยบายพร็อกซีขาออก กฎ web application firewall หรือ access gateway ที่ต้องการการอนุญาตของตนเอง

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

  • ตรวจสอบ: เปรียบเทียบ public egress IP และเส้นทางเครือข่ายของ deployment ที่ล้มเหลวกับสภาพแวดล้อมที่ทราบว่าทำงานได้
  • แก้ไข: แก้ไข allowlist การตั้งค่าพร็อกซี หรือกฎความปลอดภัยที่กำหนดขอบเขตอย่างเหมาะสมผ่านทีมโครงสร้างพื้นฐานที่รับผิดชอบ
  • ยืนยัน: ส่งคำขอซ้ำจาก runtime เดิมหลังเปลี่ยนนโยบาย

อย่าปิดการตรวจสอบใบรับรอง TLS หรือหลีกเลี่ยงการควบคุมความปลอดภัยในวงกว้าง ความล้มเหลวของ CORS ในเบราว์เซอร์ต้องวินิจฉัยแยกต่างหาก ให้ตรวจสอบว่าคำขอที่ถูกปฏิเสธเป็นคำขอ preflight OPTIONS หรือเป็นการเรียก API จริง ไม่ควรเปิดเผยข้อมูลลับของ Tracking API ที่ใช้งานระยะยาวในโค้ดเบราว์เซอร์

ใช้คำขอขั้นต่ำเพื่อแยกสาเหตุของปัญหา

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

curl --include \
  --request "$DOCUMENTED_METHOD" \
  --url "$DOCUMENTED_ENDPOINT" \
  --header "$DOCUMENTED_AUTH_HEADER: $DOCUMENTED_AUTH_VALUE"

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

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

การใช้การตรวจสอบกับการบูรณาการ 17TRACK

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

เปรียบเทียบคำขอตามเอกสารกับคำขอที่ออกจากเซิร์ฟเวอร์ของคุณ จากนั้นตรวจสอบทั้งการตอบกลับ HTTP และฟิลด์การตอบกลับที่ระบุไว้ในเอกสาร หากจำเป็นต้องส่งต่อปัญหา ให้ส่งตัวอย่างที่ปกปิดข้อมูล เวลาประทับ endpoint รายละเอียดการตอบกลับ และตัวระบุคำขอเมื่อมี อย่าใส่ API secret ในรายงาน

หยุดการลองซ้ำแบบไม่ตรวจสอบและยืนยันการกู้คืน

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

ก่อนเล่นซ้ำการดำเนินการเขียน ให้ตรวจสอบพฤติกรรมด้าน idempotency หรือการจัดการรายการซ้ำของผู้ให้บริการ เรื่องนี้สำคัญเมื่อตัวกลางทำให้ไม่แน่ใจว่าการดำเนินการเดิมมีผลลัพธ์อย่างไร

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

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

เหตุใดคำขอจึงทำงานในเครื่อง แต่ล้มเหลวใน production

เปรียบเทียบเวอร์ชันข้อมูลลับ base URL พร็อกซีขาออก egress IP นาฬิการะบบ และการตั้งค่ารันไทม์ ความสำเร็จในเครื่องยืนยันว่าเส้นทางคำขอหนึ่งทำงานได้ แต่ไม่ได้ยืนยันว่า production ส่งคำขอเดียวกันหรือมีสิทธิ์เหมือนกัน

ฉันควรสร้าง API key ใหม่ทันทีหรือไม่

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

หมายเลขติดตามที่ไม่ถูกต้องทำให้เกิด 401 หรือ 403 ได้หรือไม่

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

403 หมายความว่าการสมัครสมาชิก API ของฉันหมดอายุหรือไม่

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

ควรใส่ข้อมูลอะไรในคำขอรับการสนับสนุน

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

แหล่งข้อมูล

  • RFC 9110: HTTP Semantics — การยืนยันตัวตน HTTP ความหมายของส่วนหัว และคำจำกัดความของ 401 กับ 403
  • RFC 6750: OAuth 2.0 Bearer Token Usage — การตอบกลับข้อผิดพลาดของ bearer token โทเค็นไม่ถูกต้อง และขอบเขตสิทธิ์ไม่เพียงพอ
  • เอกสาร 17TRACK API — เอกสารอ้างอิงเฉพาะของผู้ให้บริการสำหรับการติดตั้งใช้งานและแก้ไขปัญหาคำขอ 17TRACK API