วิธีอิมพอร์ตไฟล์ HAR เข้า Apidog (แปลงทราฟฟิกที่บันทึกเป็น API Endpoints)

คุณเห็นแอปทำการร้องขอในเบราว์เซอร์ มันทำงานได้ ข้อมูลอยู่ในแท็บ Network เรียบร้อยแล้ว ตอนนี้คุณต้องการให้การเรียกใช้นั้นเป็น Endpoint ที่มีเอกสารกำกับ ซึ่งคุณสามารถบันทึก, จำลอง (mock) และทดสอบได้ โดยไม่ต้องพิมพ์ URL, เฮดเดอร์ และ JSON body ซ้ำด้วยมือ

ช่องว่างระหว่าง "ทราฟฟิกที่มองเห็นได้" กับ "Endpoint ที่สามารถนำมาใช้ซ้ำได้" คือสิ่งที่ไฟล์ HAR จะเข้ามาช่วยเติมเต็ม เบราว์เซอร์ของคุณบันทึกทุกการร้องขอและการตอบกลับอยู่แล้ว ส่งออกการบันทึกนั้น แล้วนำไปให้ Apidog จากนั้นการเรียกใช้ที่ถูกบันทึกแต่ละรายการจะกลายเป็น Endpoint จริงในโปรเจกต์ของคุณ คู่มือนี้จะแนะนำตลอดเส้นทาง: ตั้งแต่การจับ HAR ใน Chrome DevTools, นำเข้าด้วยตัวเลือกที่เหมาะสม, และทำความสะอาด Endpoint ที่สร้างขึ้นเพื่อให้รายการยังคงมีประโยชน์ สำหรับภาพรวมที่กว้างขึ้นเกี่ยวกับขั้นตอนการจับภาพ คู่มือของเราที่เกี่ยวกับ เครื่องมือจับแพ็กเก็ตด้วย Apidog จะครอบคลุมในส่วนที่เกี่ยวข้อง

คุณสามารถ ดาวน์โหลด Apidog ได้ฟรีและทำตามไปด้วยกันบนหน้าจอเดียวกัน

ไฟล์ HAR คืออะไรและทำไมทราฟฟิกที่ถูกจับไว้จึงมีคุณค่า

HAR ย่อมาจาก HTTP Archive ตามเอกสาร Apidog ไฟล์ .har คือ "ไฟล์ในรูปแบบ JSON ที่ใช้สำหรับการบันทึกการโต้ตอบของเว็บเบราว์เซอร์กับเว็บไซต์ มันบันทึกการร้องขอเว็บ, การตอบกลับ, เฮดเดอร์ และข้อมูลอื่นๆ ที่ส่งระหว่างเบราว์เซอร์และเซิร์ฟเวอร์"

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

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

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

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

ขั้นตอนที่ 1: บันทึก HAR ใน DevTools ของเบราว์เซอร์ของคุณ

การบันทึกจะเกิดขึ้นในเบราว์เซอร์ของคุณ ไม่ใช่ใน Apidog ทั้ง Chrome และ Edge ใช้ DevTools ชุดเดียวกัน ดังนั้นขั้นตอนจึงเหมือนกันทั้งหมด สมมติว่าคุณต้องการบันทึกทราฟฟิกเบื้องหลังหน้าประวัติการสั่งซื้อ

1. เปิดหน้าที่คุณต้องการบันทึก เข้าสู่ระบบก่อนหาก API ต้องการเซสชัน เนื่องจาก HAR จะบันทึกการร้องขอเหล่านั้นด้วย
2. เปิด Developer Tools กด F12, หรือ Ctrl+Shift+I บน Windows และ Linux, หรือ Cmd+Opt+I บน Mac
3. เปลี่ยนไปที่แท็บ Network นี่คือที่ที่ DevTools จะแสดงรายการการร้องขอทั้งหมดที่หน้าเว็บทำ
4. รีเฟรชหน้าเว็บ หรือคลิกผ่านการกระทำที่คุณต้องการบันทึกทราฟฟิก การโหลดหน้าประวัติการสั่งซื้อจะส่งการเรียกไปยัง /api/orders, /api/orders/{id} และสิ่งที่หน้าเว็บต้องการอื่นๆ แต่ละรายการจะแสดงขึ้นมาเป็นแถว
5. คลิกขวาที่แถวการร้องขอใดๆ แล้วเลือก Save all as HAR with content เลือกตำแหน่งและบันทึกไฟล์ ตัวอย่างเช่น order-history.har หากคำพูดในเมนูทำให้คุณสับสน เอกสารอ้างอิง Network ของ Chrome DevTools จะอธิบายขั้นตอนการจับภาพและการส่งออกที่เหมือนกัน

ส่วน "with content" นั้นสำคัญ มันบอกให้ DevTools รวมเนื้อหาการตอบกลับ ไม่ใช่แค่ข้อมูลเมตาของการร้องขอเท่านั้น หากไม่มีส่วนนี้ Endpoint ที่คุณนำเข้าจะมีเพียงรูปแบบการร้องขอ แต่ไม่มีตัวอย่างการตอบกลับ

การตรวจสอบอย่างรวดเร็วก่อนที่คุณจะออกจากเบราว์เซอร์: หากคุณเปิดไฟล์ .har ในโปรแกรมแก้ไขข้อความ มันคือ JSON ที่สามารถอ่านได้ คุณจะเห็นอาร์เรย์ entries ซึ่งแต่ละรายการมีออบเจกต์ request และ response นั่นคือโครงสร้างที่ Apidog อ่าน

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

ขั้นตอนที่ 2: นำเข้า HAR เข้าสู่ Apidog

เมื่อบันทึกไฟล์แล้ว ให้ย้ายไปที่ Apidog ตัวนำเข้าอยู่ที่เดียว

1. เปิดโปรเจกต์ของคุณแล้วไปที่ Settings > Import Data > Manual
2. เลือก HAR เป็นรูปแบบ
3. อัปโหลดไฟล์ .har ของคุณ ตัวอย่างเช่น order-history.har ที่คุณบันทึกไว้เมื่อสักครู่

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

ตัวเลือกที่ 1: วิธีจัดการกับ BaseURL

ทุกการร้องขอที่ถูกบันทึกจะมี URL เต็มรูปแบบ เช่น https://api.shop.example.com/v1/orders/123 คุณมีสองทางเลือกในการจัดการกับส่วนที่เป็นโฮสต์:

• Hardcode จะเก็บ BaseURL ไว้ภายในพาธของแต่ละ Endpoint ทุก Endpoint จะมีพรีฟิกซ์เต็มรูปแบบ https://api.shop.example.com
• Remove (แนะนำ) จะลบ BaseURL ออกเพื่อให้พาธของ Endpoint กลายเป็น /v1/orders/123 จากนั้นโฮสต์จะถูก จัดการทั่วโลกผ่านตัวแปรสภาพแวดล้อม

เลือกตัวเลือก Remove เว้นแต่คุณมีเหตุผลที่จะไม่เลือก นี่คือการตั้งค่าที่แนะนำด้วยเหตุผล: เมื่อ Base URL อยู่ในตัวแปรสภาพแวดล้อม คุณสามารถชี้ Endpoint เดียวกันไปยังเซิร์ฟเวอร์ Production, Staging, หรือเซิร์ฟเวอร์ภายในเครื่องได้โดยการสลับสภาพแวดล้อม โดยไม่ต้องแก้ไข Endpoint เอง การฮาร์ดโค้ดจะผูก Endpoint ทุกรายการเข้ากับโฮสต์ที่คุณบันทึกมาจาก ซึ่งจะยุ่งยากทันทีที่คุณต้องการทดสอบกับเซิร์ฟเวอร์อื่น

ตัวเลือกที่ 2: การยกเว้นทรัพยากรคงที่

นี่คือสวิตช์ที่จะช่วยให้คุณรอดพ้นจากรายการ Endpoint ที่ยุ่งเหยิง ตัวเลือก Static Resource ที่ตั้งค่าเป็น Exclude จะบอกให้ Apidog ข้ามไฟล์รูปภาพ, CSS และ JavaScript ที่ถูกบันทึกไว้ การโหลดหน้าเว็บเพียงครั้งเดียวสามารถสร้างไฟล์เหล่านี้ได้หลายสิบไฟล์ และไม่มีไฟล์ใดเป็น API Endpoint ที่คุณต้องการทำเอกสาร

เปิด Exclude สำหรับการนำเข้าเกือบทุกครั้ง สิ่งที่เหลืออยู่หลังจากการกรองคือทราฟฟิก API จริง: การเรียกใช้ JSON ไปยัง /api/orders และที่เกี่ยวข้อง ไม่ใช่การร้องขอ logo.png

ตัวเลือกที่ 3: การสร้างเคสทดสอบสำหรับแต่ละ Endpoint

ตัวเลือกที่สามคือ Endpoint Case Generation เปิด ON แล้ว Apidog จะสร้างเคสทดสอบเริ่มต้นสำหรับแต่ละ Endpoint ขณะที่นำเข้า เคสทดสอบคือการเรียกใช้งาน Endpoint ที่บันทึกไว้และสามารถรันได้ โดยมีค่าที่บันทึกไว้เติมมาให้แล้ว

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

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

นี่คือลักษณะโดยประมาณของ Endpoint ที่ถูกนำเข้าเมื่อมันถูกนำมาใช้ โดยใช้การเรียกคำสั่งซื้อเป็นตัวอย่าง:

GET /v1/orders/123
Host: api.shop.example.com
Authorization: Bearer <token-from-capture>
Accept: application/json

และการตอบกลับที่ถูกบันทึกซึ่ง Apidog เก็บไว้ควบคู่กัน:

{
  "id": 123,
  "status": "shipped",
  "total": 48.5,
  "currency": "USD",
  "items": [
    { "sku": "TSHIRT-BLK-M", "qty": 2, "price": 19.25 }
  ],
  "createdAt": "2026-07-14T09:31:00Z"
}

การตอบกลับนั้นเป็นข้อมูลจริงที่เซิร์ฟเวอร์ส่งคืนมา ซึ่งทำให้เป็นพื้นฐานที่แข็งแกร่งสำหรับการจำลอง (mock) หรือการยืนยันการทดสอบ

ขั้นตอนที่ 3: ทำความสะอาด Endpoint ที่สร้างขึ้น

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

• กำจัดสิ่งรบกวน. แม้จะตั้งค่า Static Resource เป็น Exclude คุณก็อาจพบ analytics pings, health checks, หรือการเรียกใช้จากบุคคลที่สามที่คุณไม่สนใจ ลบ Endpoint ที่คุณจะไม่ใช้เพื่อให้ tree สะท้อนถึง API จริงของคุณ
• เปลี่ยนชื่อและจัดกลุ่ม. Endpoint ที่ถูกบันทึกจะถูกตั้งชื่อตามพาธของมัน ซึ่งใช้งานได้แต่ขาดความเป็นระเบียบ ตั้งชื่อให้ชัดเจน ("รับคำสั่งซื้อตาม ID" แทนที่จะเป็น /v1/orders/123) และจัดระเบียบเป็นโฟลเดอร์ที่ตรงกับโครงสร้าง API ของคุณ
• แก้ไขพารามิเตอร์พาธ. การบันทึก /v1/orders/123 จะถูกนำเข้าเป็นพาธตามตัวอักษร หาก 123 คือรหัสคำสั่งซื้อจริงๆ ให้แก้ไข Endpoint เพื่อให้ส่วนนั้นกลายเป็นพารามิเตอร์พาธ {orderId} การเปลี่ยนแปลงเพียงครั้งเดียวนั้นจะเปลี่ยนการเรียกใช้ที่ถูกบันทึกเพียงครั้งเดียวให้เป็น Endpoint ที่นำกลับมาใช้ซ้ำได้ซึ่งใช้ได้กับคำสั่งซื้อใดๆ
• ล้างข้อมูลลับก่อนที่คุณจะแชร์. ข้อนี้ง่ายที่จะลืม HAR ของคุณบันทึกโทเค็นการยืนยันตัวตนใดๆ ที่ใช้งานอยู่ในเซสชันนั้น และมันก็จะติดมากับเฮดเดอร์ ก่อนที่คุณจะคอมมิตโปรเจกต์หรือแชร์กับเพื่อนร่วมทีม ให้ย้ายโทเค็นไปยังตัวแปรสภาพแวดล้อมและล้างข้อมูลรับรองที่ถูกบันทึกออกจากตัวอย่าง เอกสารของ Stripe ก็เน้นย้ำถึงประเด็นเดียวกันเกี่ยวกับการไม่ปล่อยให้คีย์ที่ใช้งานจริงรั่วไหลเข้าไปในสิ่งประดิษฐ์ที่แชร์ได้ และ HAR ก็เป็นสิ่งประดิษฐ์ประเภทหนึ่งที่ทำให้สิ่งเหล่านี้รั่วไหลได้
• ตรวจสอบความถูกต้องของเนื้อหา. หากเนื้อหาว่างเปล่าในจุดที่คุณคาดหวังข้อมูล คุณอาจส่งออกโดยไม่ได้เลือก "with content" บันทึกใหม่โดยใช้ Save all as HAR with content แล้วนำเข้าใหม่

เมื่อ Endpoint ถูกทำความสะอาดแล้ว มันจะทำงานเหมือน Endpoint อื่นๆ ใน Apidog คุณสามารถทำเอกสาร, สร้าง mock จากแต่ละการตอบกลับ และสร้างการทดสอบได้ คู่มือการเขียนสถานการณ์ทดสอบใน Apidog จะดำเนินการต่อจากจุดนี้อย่างเป็นธรรมชาติ และหากคุณต้องการโค้ดไคลเอ็นต์แบบมีประเภท (typed client code) จาก Endpoint เหล่านี้ โปรดดู วิธีสร้างโค้ดไคลเอ็นต์ด้วย Apidog

ความหลากหลายและข้อจำกัดที่แท้จริง

มีบางสถานการณ์ที่เกิดขึ้นบ่อยพอที่จะกล่าวถึง

ยังไม่มีเครื่องบันทึกอัตโนมัติ

คุณอาจคาดหวังว่า Apidog จะทำงานอยู่เบื้องหลังและบันทึกทราฟฟิกแบบสด เหมือนที่พร็อกซีทำ แต่มันไม่เป็นเช่นนั้น และควรบอกให้ชัดเจน เอกสารระบุไว้อย่างชัดเจนว่า: "ปัจจุบัน Apidog ยังไม่รองรับฟังก์ชันบันทึก Endpoint อัตโนมัติ แต่มีแผนที่จะรองรับในอนาคต"

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

ส่วนขยายเบราว์เซอร์ Apidog เป็นเครื่องมือที่แตกต่างกัน

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

การบันทึก HAR มาจาก DevTools ของเบราว์เซอร์ของคุณเองเท่านั้น หากคุณใช้ส่วนขยายสำหรับการทดสอบ โปรดทราบว่าเบราว์เซอร์มีข้อจำกัด: มันจะบล็อกเฮดเดอร์บางอย่าง เช่น Cookie, Host, Origin และ Content-Length, มันจะไม่ส่งเนื้อหาในการร้องขอ GET หรือ HEAD และมันไม่สามารถเข้าถึงโค้ดภายในเครื่องหรือฐานข้อมูลที่อยู่เบื้องหลังเครื่องของคุณได้ สำหรับการจับทราฟฟิกเพื่อนำเข้า ให้ใช้ DevTools และการส่งออก HAR สำหรับการแก้ไขข้อบกพร่องที่หนักกว่าซึ่งต้องการการควบคุมเฮดเดอร์อย่างสมบูรณ์ ไคลเอ็นต์ Apidog Desktop ไม่มีข้อจำกัดที่เบราว์เซอร์กำหนดไว้เช่นนั้น

รูปแบบอื่นๆ ก็นำเข้าได้ในลักษณะเดียวกัน

HAR เป็นหนึ่งในหลายรูปแบบที่หน้าจอ Settings > Import Data > Manual ยอมรับ หากคุณมีไฟล์ OpenAPI หรือ Swagger อยู่แล้ว การนำเข้าไฟล์เหล่านั้นจะให้ผลลัพธ์ที่สะอาดกว่าการบันทึก เนื่องจากสเปกถูกจัดโครงสร้างมาอย่างตั้งใจ คำแนะนำของเราเกี่ยวกับการ โยกย้ายเอกสาร API ของ Swagger ไปยัง Apidog ครอบคลุมเส้นทางนั้น และหากคุณมาจาก Postman คู่มือการโยกย้ายสภาพแวดล้อมและคอลเล็กชันของ Postman ก็ทำเช่นกัน ใช้ HAR เมื่อไม่มีสเปกจริงอยู่ และทราฟฟิกที่ถูกบันทึกเป็นบันทึกที่ดีที่สุดที่คุณมี

ทำงานอัตโนมัติด้วย Apidog CLI

การนำเข้า HAR ไม่จำเป็นต้องเป็นขั้นตอน GUI Apidog CLI มีคำสั่ง import ที่อ่านไฟล์ HAR ได้โดยตรง ซึ่งเป็นสิ่งที่คุณต้องการเมื่อการบันทึกเกิดขึ้นบนเซิร์ฟเวอร์, เมื่อคุณเขียนสคริปต์การนำเข้าใน pipeline, หรือเมื่อคุณให้ AI coding agent เปลี่ยนการบันทึกให้เป็น Endpoint:

npm install -g apidog-cli
apidog login --with-token <YOUR_ACCESS_TOKEN>

# Turn a captured HAR into endpoints in your project
apidog import --project <PROJECT_ID> --format har --file ./capture.har

แฟล็ก --format ยังยอมรับ openapi, postman, wsdl, insomnia และอื่นๆ ดังนั้นคำสั่งเดียวจึงครอบคลุมแหล่งที่มาการนำเข้าส่วนใหญ่ เมื่อ Endpoint มีอยู่แล้วและคุณได้บันทึกไว้ในสถานการณ์ทดสอบ ให้รันสถานการณ์นั้นแบบ Headless ใน CI:

apidog run --access-token $APIDOG_ACCESS_TOKEN \
  -t <SCENARIO_ID> -e <ENV_ID> -r cli

ในที่นี้ -t คือ ID ของสถานการณ์ทดสอบที่บันทึกไว้, -e คือ ID สภาพแวดล้อม (ตัวแปรสภาพแวดล้อมเดียวกับที่เก็บ BaseURL ของคุณ), และ -r เลือกตัวรายงาน, cli สำหรับเอาต์พุตคอนโซล สร้างสถานการณ์ด้วย คู่มือการเขียนสถานการณ์ทดสอบใน Apidog จากนั้นเชื่อมต่อคำสั่งทั้งสองเข้ากับ Pipeline ของคุณด้วย คู่มือ Apidog CLI CI/CD

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

เบราว์เซอร์ใดบ้างที่สามารถส่งออกไฟล์ HAR ได้?

เบราว์เซอร์ที่ใช้ Chromium พร้อม DevTools จะทำได้ในลักษณะเดียวกัน ดังนั้น Chrome และ Edge ทั้งคู่ใช้แท็บ Network และรายการเมนู Save all as HAR with content เอกสาร Apidog ครอบคลุมเส้นทางของ Chrome และ Edge โดยเฉพาะ เบราว์เซอร์อื่นๆ มีเมนูส่งออกของตนเอง แต่ป้ายกำกับอาจแตกต่างกัน ดังนั้นให้ตรงกับคำศัพท์ใน DevTools ของเบราว์เซอร์ของคุณเอง

รายการ Endpoint ที่นำเข้าของฉันมีขนาดใหญ่มาก เกิดอะไรขึ้น?

คุณน่าจะปล่อยให้ Static Resource ตั้งค่าให้รวมทุกอย่าง การโหลดหน้าเว็บจะดึงรูปภาพ, CSS และสคริปต์เข้ามา และทั้งหมดเหล่านั้นก็จะอยู่ใน HAR นำเข้าไฟล์ใหม่โดยตั้งค่าตัวเลือก Static Resource เป็น Exclude แล้วรายการจะถูกจำกัดเฉพาะการเรียกใช้ API จริง คุณยังสามารถลบส่วนเกินออกด้วยตนเองในภายหลังได้

ฉันควรเลือก Hardcode หรือ Remove สำหรับ BaseURL?

เลือก Remove (แนะนำ) ในเกือบทุกกรณี ตัวเลือกนี้จะดึงโฮสต์ออกจากพาธของแต่ละ Endpoint เพื่อให้คุณสามารถจัดการได้ทั่วโลกผ่านตัวแปรสภาพแวดล้อม ซึ่งช่วยให้คุณสลับระหว่าง Production, Staging และ Local ได้โดยไม่ต้องแก้ไข Endpoint การตั้งค่าเดียวกันนี้คือสิ่งที่ สถานการณ์ทดสอบใน Apidog อ่านเมื่อมันทำงาน เลือก Hardcode เฉพาะเมื่อคุณต้องการให้ URL เต็มรูปแบบถูกฝังอยู่ในแต่ละพาธเท่านั้น

HAR รวมโทเค็นการยืนยันตัวตนของฉันด้วยหรือไม่?

ใช่ และนั่นคือข้อควรระวัง HAR จะบันทึกเฮดเดอร์จริงที่ส่งระหว่างเซสชัน ดังนั้นโทเค็น Bearer หรือคุกกี้ใดๆ ที่ใช้งานอยู่จะอยู่ในไฟล์ ปฏิบัติกับ HAR เหมือนความลับ: อย่าคัดลอกลงในประเด็นสาธารณะ และหลังจากนำเข้า ให้ย้ายข้อมูลรับรองไปยังตัวแปรสภาพแวดล้อม และล้างข้อมูลเหล่านั้นออกจากตัวอย่างที่บันทึกไว้ก่อนที่จะแชร์โปรเจกต์

ฉันสามารถข้าม GUI และนำเข้า HAR จากบรรทัดคำสั่งได้หรือไม่?

ได้ คำสั่ง apidog import --project <id> --format har --file <path> ของ Apidog CLI จะนำเข้า HAR เข้าสู่โปรเจกต์ของคุณโดยไม่ต้องเปิดแอป ซึ่งเป็นสิ่งที่คุณต้องการเมื่อการบันทึกเกิดขึ้นบนเซิร์ฟเวอร์หรือภายในงาน CI GUI ยังคงให้ตัวเลือกการนำเข้าแบบโต้ตอบ (การจัดการ BaseURL, การกรอง Static Resource) สำหรับการบันทึกแบบครั้งเดียว ดังนั้นให้เลือกสิ่งที่เหมาะสม: CLI สำหรับการนำเข้าแบบสคริปต์หรือตัวแทน, GUI เมื่อคุณต้องการปรับแต่งการนำเข้าด้วยตนเอง หลังจากนำเข้า apidog run จะเล่น สถานการณ์ทดสอบ ที่คุณสร้างจาก Endpoint เหล่านั้นซ้ำ

สรุป

ไฟล์ HAR เป็นสะพานเชื่อมระหว่างทราฟฟิกที่คุณมองเห็นได้กับ Endpoint ที่คุณสามารถนำกลับมาใช้ซ้ำได้ บันทึกเซสชันใน DevTools ของเบราว์เซอร์ของคุณด้วย Save all as HAR with content, นำเข้าผ่าน Settings > Import Data > Manual โดยเลือก Remove สำหรับ BaseURL และตั้งค่า Static Resource เป็น Exclude จากนั้นใช้เวลาสักครู่ในการเปลี่ยนชื่อ, กำหนดพารามิเตอร์ และล้างข้อมูลลับ สิ่งที่คุณจะได้คือชุด Endpoint ที่ใช้งานได้ซึ่งคุณสามารถทำเอกสาร, จำลอง (mock) และทดสอบได้

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