DEV Community

Cover image for APIDOG อัปเดตเดือนมิถุนายน: เวิร์กโฟลว์ CLI พลัง AI, นำเข้าราบรื่นยิ่งขึ้น และรีเฟรช OAuth 2.0 อัตโนมัติ
Thanawat Wongchai
Thanawat Wongchai

Posted on • Originally published at apidog.com

APIDOG อัปเดตเดือนมิถุนายน: เวิร์กโฟลว์ CLI พลัง AI, นำเข้าราบรื่นยิ่งขึ้น และรีเฟรช OAuth 2.0 อัตโนมัติ

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

ลองใช้ Apidog วันนี้

เป้าหมายของรอบนี้คือการลดงานซ้ำ ๆ ในทีม API: ให้เอเจนต์ AI ทำงานกับทรัพยากรโปรเจกต์จริงได้เป็นระบบมากขึ้น, ลดการแก้ไขหลังนำเข้า, ทำให้คำขอที่ใช้ OAuth ทำงานต่อเนื่อง และทำให้การตั้งค่าทดสอบ/มอนิเตอร์ทำได้เร็วขึ้น

การอัปเดตใหม่

Apidog CLI รองรับเวิร์กโฟลว์ API ที่ขับเคลื่อนด้วย AI

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

สิ่งที่ทำได้ดีขึ้นในรอบนี้:

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

แนวทางใช้งานที่เหมาะกับทีมพัฒนา:

  1. ให้ AI ช่วยตรวจหรือสร้างการเปลี่ยนแปลงจากบริบทของโปรเจกต์
  2. ใช้ CLI ตรวจสอบหรือรันกรณีทดสอบก่อนบันทึกกลับ
  3. ส่งออกเฉพาะขอบเขตที่ต้องการ เช่น บางโมดูลหรือบางกลุ่ม API
  4. ลดการคาดเดาของ AI ด้วยทรัพยากรที่มีโครงสร้างจาก Apidog

คิดว่า CLI เป็นสะพานระหว่างคำสั่งภาษามนุษย์ของ AI กับการทำงานที่เป็นระบบในโปรเจกต์ Apidog

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

การปรับปรุงการนำเข้าและส่งออก

รอบนี้ปรับปรุงเวิร์กโฟลว์นำเข้า/ส่งออก โดยเฉพาะทีมที่ย้ายข้อมูลจาก Postman หรือดูแลข้อกำหนด API ผ่าน OpenAPI/Swagger

สิ่งที่เปลี่ยน:

  • เมื่อนำเข้าผ่าน Postman API, Apidog สามารถลบช่องว่างออกจากชื่อตัวแปรได้
  • เมื่อนำเข้าเวิร์กสเปซผ่าน Postman API, Apidog สามารถเปลี่ยนชื่อ My Workspace ให้ชัดเจนขึ้นโดยอิงจากผู้สร้างเวิร์กสเปซ
  • การนำเข้า/ส่งออก OpenAPI และ Swagger รองรับพารามิเตอร์ประเภทอ็อบเจกต์และพารามิเตอร์ประเภทการอ้างอิง

ตัวอย่างปัญหาที่ลดลงหลังนำเข้า:

ก่อนหน้า ตอนนี้
ตัวแปรที่นำเข้าอาจต้องแก้ชื่อด้วยตนเอง การนำเข้า Postman API สามารถลบช่องว่างออกจากชื่อตัวแปรได้
เวิร์กสเปซหลายรายการอาจใช้ชื่อที่สับสน เช่น My Workspace ชื่อเวิร์กสเปซที่ไม่ชัดเจนสามารถเปลี่ยนให้ระบุได้ง่ายขึ้น
พารามิเตอร์ OpenAPI ที่ซับซ้อนอาจต้องปรับหลังนำเข้า/ส่งออก OpenAPI/Swagger รองรับพารามิเตอร์ประเภทอ็อบเจกต์และการอ้างอิงมากขึ้น

แนวทางแนะนำหลังย้ายข้อมูล:

  1. ตรวจสอบชื่อตัวแปร environment/collection หลังนำเข้า
  2. จัดกลุ่มเวิร์กสเปซที่นำเข้าตามผู้สร้างหรือทีมที่เกี่ยวข้อง
  3. ตรวจสอบ OpenAPI schema ที่มี object/reference parameter เพื่อยืนยันว่าโครงสร้างยังถูกต้อง
  4. รันคำขอหรือกรณีทดสอบหลักเพื่อเช็กว่า endpoint ยังทำงานตามคาด

OAuth 2.0 รองรับการรีเฟรชโทเค็นอัตโนมัติ

OAuth 2.0 ใน Apidog รองรับการรีเฟรชโทเค็นอัตโนมัติแล้ว

เมื่อ access token ใกล้หมดอายุหรือหมดอายุไปแล้ว Apidog สามารถรีเฟรชโทเค็นให้โดยอัตโนมัติ ทำให้คุณส่งคำขอต่อได้โดยไม่ต้องยืนยันตัวตนใหม่หรือคัดลอกโทเค็นด้วยตนเอง

เหมาะกับงานเหล่านี้:

  • ดีบัก API ที่ป้องกันด้วย OAuth
  • รันคำขอซ้ำระหว่างพัฒนา
  • ตรวจสอบชุด API ที่ต้องใช้ session ต่อเนื่อง
  • ทดสอบ flow ที่ใช้ token ระยะสั้น

ฟีเจอร์นี้ช่วยลดการหยุดชะงักระหว่างดีบัก API, ทดสอบ และตรวจสอบคำขอซ้ำ ๆ

การปรับปรุงตามคำแนะนำของผู้ใช้

ความเข้ากันได้กับ MCP Client ที่ดีขึ้น

Apidog ปรับปรุงความเข้ากันได้กับ MCP Client และสามารถแยกวิเคราะห์สคีมาที่ไม่ได้มาตรฐานได้เสถียรขึ้น

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

ค้นหาขั้นตอนแบบคงที่ด้วยชื่อในชุดทดสอบ

เมื่อเพิ่มขั้นตอนแบบคงที่ในชุดทดสอบ ตอนนี้สามารถค้นหาด้วยชื่อได้แล้ว

สำหรับโปรเจกต์ที่มีเอนด์พอยต์, กรณีทดสอบ หรือสถานการณ์จำนวนมาก วิธีนี้ช่วยลดเวลาในการเลื่อนหา item ในรายการยาว ๆ

แนวทางใช้งาน:

  1. เปิดชุดทดสอบที่ต้องการแก้ไข
  2. เพิ่มขั้นตอนแบบคงที่
  3. ค้นหาด้วยชื่อ endpoint/test case/scenario
  4. เลือกรายการที่ต้องการและเพิ่มลงในชุดทดสอบ

งานที่กำหนดเวลาเพิ่มตัวเลือก “ทุก 8 ชั่วโมง”

งานที่กำหนดเวลารองรับตัวเลือก “ทุก 8 ชั่วโมง” แล้ว

เหมาะสำหรับ:

  • รัน automated test เป็นรอบ ๆ
  • ตรวจสอบ API health ระหว่างวัน
  • ทำ monitoring แบบ periodic
  • ตรวจ regression ในช่วงเวลาที่ถี่กว่า daily แต่ไม่ถี่เกินไป

ตัวอย่างรอบการรันที่พบได้บ่อย:

Use case รอบที่เหมาะสม
Smoke test ระหว่างวัน ทุก 8 ชั่วโมง
Health check รายวัน ทุก 24 ชั่วโมง
Regression test หลัก ตามรอบ release หรือ CI schedule

Apidog Web App รองรับการกำหนดค่าส่วนหัวที่สร้างขึ้นโดยอัตโนมัติ

Apidog Web App รองรับการกำหนดค่าส่วนหัวที่สร้างขึ้นโดยอัตโนมัติแล้ว

สิ่งนี้ช่วยให้ผู้ใช้ Web App ควบคุม request behavior ได้มากขึ้น โดยเฉพาะโปรเจกต์ที่มีข้อกำหนดเฉพาะเกี่ยวกับ header เช่น header มาตรฐานของทีม, header สำหรับ routing, header สำหรับ environment หรือ header ที่ต้องสอดคล้องกับ gateway/proxy

การแก้ไขข้อผิดพลาดและการปรับปรุงเล็กน้อย

รายการแก้ไขและปรับปรุงในเดือนนี้ประกอบด้วย:

  • ปรับปรุงประสิทธิภาพเมื่อเลือกสถานการณ์ทดสอบขนาดใหญ่ไปยังสาขาย่อย ลดโอกาสเกิด timeout
  • รายการสาขา Sprint และสาขาทั่วไปรองรับการแสดงรหัสสาขาและคัดลอกรหัส
  • แสดงข้อความแจ้งเตือนที่เป็นมิตรขึ้นเมื่อ macOS ไม่สามารถส่งคำขออินทราเน็ตได้
  • แก้ปัญหา Base URL ของบริการไม่ถูกนำเข้า และเอนด์พอยต์ไม่ถูกผูกกับบริการที่ระบุเมื่อนำเข้าข้อมูล Apidog ซ้ำไปยังโมดูลใหม่
  • แก้ปัญหา OAuth 1.0 ที่ตั้งค่าให้เพิ่มใน request header แต่ไม่ได้ถูกเพิ่มจริง
  • แก้ปัญหาโค้ดคำขอเอนด์พอยต์ที่สร้างขึ้นทำงานไม่ถูกต้องเมื่อ Basic Auth ใช้ตัวแปรภาษาจีน
  • แก้ปัญหาโค้ดคำขอที่สร้างขึ้นใช้ HTTPS ไม่ถูกต้องเมื่อเอนด์พอยต์ใช้ HTTP
  • แก้ปัญหาการรันสถานการณ์ CLI อาจรายงาน Unexpected token เมื่อขั้นตอนสถานการณ์อ้างอิง response body ในรูปแบบ raw
  • แก้ปัญหารายละเอียดรายงานการทดสอบยังแสดงว่ากำลังทำงาน หลังจากสถานการณ์ทดสอบอัตโนมัติถูกยกเลิกผิดปกติ
  • แก้ปัญหารายงานที่เกี่ยวข้องไม่แสดงในรายการรายงานการทดสอบหลังจากรันกรณีสถานการณ์ในโฟลเดอร์หลัก
  • แก้ปัญหาเมื่อรีเฟรช Apidog Web App แล้วโปรเจกต์กลับไปที่สาขาหลักโดยอัตโนมัติ
  • แก้ปัญหาตัวเลือกตัวกรองแท็กไม่มีเนื้อหาระหว่างการนำเข้าสาขาและเมื่อแทรกเอนด์พอยต์ใน Markdown
  • แก้ปัญหาบริการที่ไม่ใช่ค่าเริ่มต้นถูกเพิ่มซ้ำเมื่อนำเข้าไฟล์ Apidog ที่มีหลายโมดูลและบริการ
  • แก้ปัญหาแท็กเอกสาร Markdown ไม่ถูกนำเข้าอย่างถูกต้องเมื่อนำเข้าข้อมูล Apidog
  • แก้ปัญหายังคงแสดง conflict หลังจากรวมเอนด์พอยต์เข้ากับสาขาหลักในบางกรณี
  • แก้ปัญหา frontend error ในบางกรณีเมื่อดีบักเอนด์พอยต์ SSE
  • แก้ปัญหาสถิติโปรเจกต์ On-Premises นับเฉพาะข้อมูลจากโมดูลเริ่มต้น
  • แก้ปัญหาการนำเข้าไฟล์ Apidog แบบหลายโมดูลจากหน้ารายละเอียดทีมนำเข้าเอนด์พอยต์ไปยังโมดูลเริ่มต้นผิด
  • แก้ปัญหาการเปลี่ยนแปลงหายไปในบางกรณีหลังจากส่งการแก้ไข
  • แก้ปัญหาแสดงข้อความข้อผิดพลาดไม่ถูกต้องในขั้นตอนยืนยันอีเมลเมื่อเปลี่ยนรหัสผ่าน

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

การอัปเดตชุดนี้ทำให้ Apidog ใช้งานได้ดีขึ้นในเวิร์กโฟลว์ที่มีทั้งนักพัฒนา, เอเจนต์ AI, ข้อกำหนด API และการทดสอบอัตโนมัติ

ส่วนที่เกี่ยวข้อง สิ่งที่ปรับปรุง ทำไมจึงสำคัญ
เวิร์กโฟลว์ CLI ที่ขับเคลื่อนด้วย AI CLI ช่วยให้เอเจนต์ AI ทำงานกับทรัพยากรโปรเจกต์ Apidog, รันกรณีทดสอบ, อ้างอิงทรัพย์สินที่มีอยู่ และควบคุมการส่งออกได้ละเอียดขึ้น เอเจนต์ AI ทำงาน API ได้จากบริบทโปรเจกต์ที่เป็นระบบ แทนที่จะเดาจากข้อมูลที่ไม่มีโครงสร้าง
การนำเข้าและส่งออก Postman API import ล้างชื่อตัวแปรและทำให้ชื่อเวิร์กสเปซชัดขึ้น; OpenAPI/Swagger รองรับพารามิเตอร์ object/reference ลดงานแก้หลังย้ายข้อมูล และรักษา API spec ที่ซับซ้อนได้ดีขึ้น
การยืนยันตัวตน OAuth 2.0 refresh token ได้อัตโนมัติ ลดการหยุดชะงักระหว่างดีบักและทดสอบ API
ความเข้ากันได้กับ MCP MCP Client แยกวิเคราะห์สคีมาที่ไม่ได้มาตรฐานได้มากขึ้น ทำงานกับเครื่องมือและเซิร์ฟเวอร์ MCP ในโลกจริงได้เสถียรขึ้น
เวิร์กโฟลว์การทดสอบ ค้นหาขั้นตอนแบบคงที่ได้ง่ายขึ้น และ scheduled job รองรับทุก 8 ชั่วโมง ตั้งค่าชุดทดสอบเร็วขึ้นและยืดหยุ่นขึ้นสำหรับการรันซ้ำ
การกำหนดค่า Web App กำหนดค่าส่วนหัวที่สร้างอัตโนมัติได้ใน Apidog Web App ควบคุม request behavior ได้ดีขึ้นในเวิร์กโฟลว์บนเบราว์เซอร์

สรุปคือทีมจะได้ flow ที่สะอาดขึ้น: AI มีบริบทโปรเจกต์ดีขึ้น, ข้อมูลนำเข้าต้องแก้น้อยลง, คำขอ OAuth ถูกขัดจังหวะน้อยลง และทีมควบคุมการทดสอบซ้ำกับการตั้งค่า request ได้มากขึ้น

เข้าร่วมการสนทนา

เชื่อมต่อกับวิศวกร API คนอื่น ๆ และทีม Apidog:

  • เข้าร่วมชุมชน Discord ของเราสำหรับการสนทนาและการสนับสนุนแบบเรียลไทม์
  • เข้าร่วมชุมชน Slack ของเราสำหรับการสนทนาทางเทคนิค
  • ติดตามเราบน X (Twitter) เพื่อรับการอัปเดตล่าสุด

ป.ล. สำหรับรายละเอียดทั้งหมดเกี่ยวกับการอัปเดตทั้งหมด โปรดดู Apidog Changelog

ขอแสดงความนับถือ,

ทีมงาน Apidog

Top comments (0)