OpenAPI DevTools - ส่วนขยาย Chrome ที่สร้างสเปก API อัตโนมัติ

 (github.com/AndrewWalsh)
3 คะแนน โดย GN⁺ 2023-10-26 | 1 ความคิดเห็น | แชร์ทาง WhatsApp
  • สร้างสเปก OpenAPI แบบเรียลไทม์จากคำขอเครือข่ายของหน้าเว็บ
  • เพิ่มแท็บใหม่ชื่อ 'OpenAPI' ใน Chrome DevTools
    • สร้างข้อกำหนด OpenAPI 3.1 สำหรับเว็บไซต์หรือแอปพลิเคชันได้ทันที
    • รวมเฮดเดอร์ คำขอ เนื้อหา และพารามิเตอร์คิวรีใหม่ของแต่ละเอนด์พอยต์โดยอัตโนมัติ
    • เมื่อคลิกพารามิเตอร์พาธ จะรวมคำขอที่ตรงกันทั้งที่มีอยู่แล้วและที่จะเกิดขึ้นในอนาคต
    • ดูข้อกำหนดภายในเครื่องมือด้วย Redocly และดาวน์โหลดได้ด้วยการคลิก
  • ส่วนขยายจะเติมข้อกำหนดโดยอัตโนมัติตามคำขอ JSON ที่เกิดขึ้นขณะสำรวจเว็บ
  • สามารถกรองโฮสต์และทำให้พาธของ URL เป็นพารามิเตอร์ได้จากเมนูการตั้งค่า
  • แม้เอนด์พอยต์เดียวกันจะตอบกลับด้วยข้อมูลที่ต่างกัน ส่วนขยายก็จะรวมข้อมูลทั้งหมดไว้ในข้อกำหนดสุดท้าย
  • กระบวนการรวมคำขอไม่สามารถย้อนกลับได้ แต่ผู้ใช้สามารถล้างข้อกำหนดและเริ่มใหม่ได้ทุกเมื่อ

บทความที่เกี่ยวข้อง

1 ความคิดเห็น

 
GN⁺ 2023-10-26
ความคิดเห็นจาก Hacker News
  • ส่วนขยาย Chrome ของ OpenAPI DevTools ได้รับการยอมรับในความสามารถในการสร้างสเปก API
  • ผู้ใช้มองว่ามีประโยชน์สำหรับการเขียนโค้ดในคอนโซล JavaScript เพื่อให้สามารถทำงานที่ซับซ้อนได้อย่างรวดเร็ว
  • ข้อเสนออย่างหนึ่งสำหรับเครื่องมือนี้คือการบันทึกเอกสารของ authentication header และเก็บค่าโทเค็นไว้เพื่อให้ใช้งาน API ได้สะดวกขึ้น
  • มีการร้องขอฟีเจอร์ปุ่ม "คัดลอกเป็น Python requests" เพื่อสร้างสไนเป็ต boilerplate ของ Python
  • เครื่องมือนี้ถูกนำไปเปรียบเทียบกับเครื่องมือคล้ายกันอย่าง vite-plugin-web-extension และ mitmproxy2swagger โดยมีการเน้นว่าความสามารถแบบส่วนขยายเบราว์เซอร์นั้นสะดวกมาก
  • เครื่องมือนี้ได้รับคำชมเรื่องความสามารถในการถอดรหัส API ของเว็บไซต์ ซึ่งอาจเป็นงานที่ค่อนข้างยาก
  • มีการตั้งคำถามเกี่ยวกับความสามารถของเครื่องมือนี้ในการจัดการค่าที่เป็นทางเลือก และการทำเครื่องหมายฟิลด์สตริงเป็น "enum"
  • เครื่องมือนี้อาจถูกมองว่าเป็นก้าวไปสู่การเปลี่ยนทั้งเว็บให้กลายเป็น API แม้จะยังมีอุปสรรคเรื่องการล็อกอิน/สมัครสมาชิกก็ตาม
  • มีข้อเสนอฟีเจอร์หลายอย่าง เช่น การกรองพร็อพเพอร์ตีของ response, การทำงานกับข้อมูลที่ไม่ใช่ JSON, การอ้างอิงไขว้กับ API ที่มีเอกสารสาธารณะและชื่อโฮสต์, การเก็บข้อมูลรับรองผู้ใช้ไว้ในเครื่อง, และการสร้างไคลเอนต์จากสเปก OpenAPI