Apidog อัปเดตเดือนกันยายน: เวิร์กโฟลว์ CLI แบบโมดูลาร์, Bitbucket Cloud และ GitLab On-Prem

ตลอด Apidog เวอร์ชัน 2.8.47–2.8.50 การอัปเดตของเดือนนี้ทำให้การทำงานอัตโนมัติของ API, การผสานรวมที่เก็บข้อมูล (repository integration) และเอกสาร API ดูแลรักษาได้ง่ายขึ้น ไม่ว่าจะเป็นการนำเข้า CLI แบบโมดูลาร์และการสร้างกรณีแก้ไขข้อบกพร่อง ไปจนถึงการเชื่อมต่อ Bitbucket Cloud, GitLab แบบโฮสต์เอง และ Schema ที่เผยแพร่จากไซต์ย่อยของ Docs

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

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

สรุปโดยย่อ:

การทำงานอัตโนมัติของ Apidog CLI: จัดการโมดูลโปรเจกต์ นำเข้าข้อมูล API หลากหลายรูปแบบตามโมดูล และสร้างกรณีทดสอบการแก้ไขข้อบกพร่องจากไฟล์การกำหนดค่า
การผสานรวมที่เก็บข้อมูล Git: เพิ่มการเชื่อมต่อ Bitbucket Cloud และ GitLab On-Prem เข้ากับเวิร์กโฟลว์การนำเข้า/ส่งออกโปรเจกต์
ความสามารถในการใช้งานในชีวิตประจำวัน: การจัดการ URL ที่ชัดเจนขึ้น การกรองรายงานการทดสอบที่ดีขึ้น การเติมตัวแปรข้อมูลการทดสอบอัตโนมัติ และรายการโปรเจกต์ที่โหลดเร็วขึ้น
Docs และการมองเห็นประสิทธิภาพ: ไซต์ย่อยของ Docs เผยแพร่ Schema และการทดสอบประสิทธิภาพรายงานเวลาตอบสนอง P95 และ P99

🤖 Apidog CLI สำหรับการทำงานอัตโนมัติของ API และเวิร์กโฟลว์ AI

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

จัดการโมดูลโปรเจกต์จาก CLI

Apidog CLI สามารถสอบถาม สร้าง อัปเดต และลบโมดูลโปรเจกต์ได้แล้ว

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

สิ่งนี้ทำให้การจัดการโมดูลเป็นส่วนหนึ่งของวงจรที่สามารถทำซ้ำได้เช่นเดียวกับการทดสอบ API และการทำงานอัตโนมัติของ CI

นำเข้าข้อมูล API เข้าสู่โมดูลที่เลือก

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

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

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

สร้างกรณีทดสอบการแก้ไขข้อบกพร่องจากการกำหนดค่า

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

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

การจัดการโมดูล การนำเข้าที่มีโครงสร้าง และการสร้างกรณีแก้ไขข้อบกพร่องร่วมกันช่วยลดงานด้วยตนเองในสคริปต์ในเครื่อง, ไปป์ไลน์ CI/CD และเวิร์กโฟลว์ที่ใช้ AI

หากคุณติดตั้ง Apidog CLI อยู่แล้ว โปรดอัปเดตก่อนใช้งานความสามารถใหม่:

npm install -g apidog-cli@latest

ดู เอกสาร Apidog CLI สำหรับข้อมูลอ้างอิงคำสั่งล่าสุด

🔗 การผสานรวมที่เก็บข้อมูล Git

เดือนกันยายนยังขยายการนำเข้า/ส่งออกที่ใช้ Git ไปยังสภาพแวดล้อมที่เก็บข้อมูลทั่วไปสองแห่ง

Bitbucket Cloud

การนำเข้าและส่งออกโปรเจกต์รองรับที่เก็บข้อมูล Bitbucket Cloud แล้ว ทีมที่ใช้ Bitbucket Cloud อยู่แล้วสามารถเก็บที่เก็บข้อมูลที่มีอยู่ไว้ในเวิร์กโฟลว์ได้ แทนที่จะย้าย API assets ไปยังแพลตฟอร์ม Git อื่น

GitLab On-Prem

องค์กรสามารถกำหนดค่าอินสแตนซ์ GitLab On-Prem ใน Apidog SaaS และใช้งานในเวิร์กโฟลว์ที่เก็บข้อมูล Git ที่รองรับได้ แต่ละองค์กรจัดการการเชื่อมต่อของตนเองอย่างอิสระ ดังนั้นทีมจึงสามารถใช้การตั้งค่า GitLab แบบโฮสต์เองที่มีอยู่ได้ต่อไป

ก่อนเชื่อมต่อ โปรดยืนยันว่าที่อยู่ของอินสแตนซ์ GitLab และสภาพแวดล้อมเครือข่ายตรงตามข้อกำหนดการเชื่อมต่อ

⚙️ การปรับปรุงในชีวิตประจำวัน

การเผยแพร่ครั้งนี้ยังแก้ไขข้อเสนอแนะบ่อยครั้งจากการทำงาน API ประจำวันอีกด้วย

URL ที่สมบูรณ์ไม่ขัดแย้งกับพาธสภาพแวดล้อมอีกต่อไป

เมื่อสร้างหรือแก้ไข HTTP API การป้อน URL ที่สมบูรณ์ซึ่งขึ้นต้นด้วย http:// หรือ https:// ตอนนี้จะซ่อนพาธสภาพแวดล้อมทันที การเปลี่ยนค่ากลับไปเป็นพาธสัมพัทธ์จะคืนค่าพาธสภาพแวดล้อม

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

การกรองรายงานการทดสอบที่มีประโยชน์มากขึ้น

รายการรายงานการทดสอบตอนนี้รองรับการกรองตาม runner และแหล่งที่มาของการรัน และได้เพิ่มฟิลด์แสดงผลที่เกี่ยวข้องเพื่อให้ง่ายต่อการจำกัดรายการรายงานที่ยาวและเปรียบเทียบบันทึกที่ผ่านมาจากแหล่งที่มาต่างๆ

ตัวแปรข้อมูลการทดสอบปรากฏในการเติมอัตโนมัติ

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

รายการโปรเจกต์ที่โหลดเร็วขึ้น

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

✨ ยังมีอะไรในการเผยแพร่ครั้งนี้อีก

สามการเปลี่ยนแปลงนี้สรุปเรื่องราวของเดือนนี้ ครอบคลุมถึงเอกสาร การทดสอบประสิทธิภาพ และการตั้งค่าโปรเจกต์ที่เน้นสเปกเป็นหลัก

เผยแพร่ Schema จากไซต์ย่อยของ Docs

ไซต์ย่อยใน Apidog Docs สามารถเผยแพร่ Schema ควบคู่ไปกับ Endpoint ได้แล้ว เพื่อให้ผู้อ่านไซต์ที่เผยแพร่แล้วสามารถเห็นได้ในที่เดียว แทนที่จะต้องสลับกลับไปยังไซต์หลัก ไซต์ย่อยขององค์กรสามารถเปิดใช้งานความสามารถนี้ได้เอง

Docs appearance settings with Schemas and Example enabled

เวลาตอบสนอง P95 และ P99 ในการทดสอบประสิทธิภาพ

ผลการทดสอบประสิทธิภาพตอนนี้รายงานเวลาตอบสนอง P95 และ P99 ควบคู่ไปกับเมตริกที่มีอยู่ เปอร์เซ็นไทล์อธิบายถึงส่วนที่ช้าที่ค่าเฉลี่ยซ่อนอยู่ ซึ่งมักจะเป็นส่วนของ API ที่ผู้ใช้สังเกตเห็นจริงๆ

การตั้งค่าโปรเจกต์ในโหมด Spec และการนำเข้า OpenAPI

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

🛠️ การแก้ไขและปรับปรุงเพิ่มเติม

รอบนี้ยังรวมถึงการแก้ไขและการเปลี่ยนแปลงเล็กน้อยดังต่อไปนี้:

ปรับปรุงวิธีการแสดงสถานะการทดลองและแอคชั่นในหน้าต่างหลักและแถบแท็บ
ปรับปรุงวิธีการแสดงคำเชิญที่รอดำเนินการในรายการสมาชิกองค์กรและทีม
แก้ไขปัญหาที่ตัวแปร Basic Auth ในโค้ดคำขอที่สร้างขึ้นไม่ได้รับการขยายและถูกเข้ารหัสโดยตรงเป็น Base64
แก้ไขปัญหาที่การแก้ไขแท็บไม่ได้ขยายฟิลด์โมเดลข้อมูลที่อ้างอิงแบบรวมโดยใช้ allOf
แก้ไขปัญหาที่การอ้างอิงข้ามโปรเจกต์ของ API ไปยังโมเดลข้อมูลไม่ถูกต้องหลังจากโคลนหรือคัดลอกโปรเจกต์
แก้ไขปัญหาที่กรณีแก้ไขข้อบกพร่องที่สร้างโดย CLI แสดงประเภทการตรวจสอบสิทธิ์เป็น “No Auth” บน Web client และไม่ใช้การตรวจสอบสิทธิ์
แก้ไขปัญหาที่นิยาม $ref การตอบสนองของ OpenAPI ถูกทิ้งโดยเงียบๆ ระหว่างการนำเข้า CLI
แก้ไขปัญหาที่ข้อมูลเมตาการแบ่งหน้าของรายการรายงานคืนค่า pageSize และ pageIndex ที่ไม่ถูกต้อง
แก้ไขปัญหาที่การสร้างทั้งรายงานการทดสอบ JUnit และ HTML ทำให้รายงาน JUnit มีเพียงผลลัพธ์ของกรณีทดสอบสุดท้ายเท่านั้น
แก้ไขปัญหาที่เมนูดรอปดาวน์สภาพแวดล้อมไม่สามารถเปิดได้เมื่อสลับสภาพแวดล้อม URL ในการทดสอบ API เดี่ยว
เพิ่มการรองรับการปิดใช้งานช่องทางการให้รางวัลเชิญบนหน้าแรกผ่านนโยบายองค์กร

สำหรับรายการรายละเอียดทั้งหมด สามารถดูได้ที่ Apidog Changelog

🌟 สิ่งนี้หมายความว่าอย่างไร

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

จุดเน้น	สิ่งที่ปรับปรุง	ทำไมจึงสำคัญ
CLI และการทำงานอัตโนมัติ	โมดูล การนำเข้า และกรณีแก้ไขข้อบกพร่องสามารถสร้างและจัดการผ่าน CLI ได้	การทำงานอัตโนมัติและเอเจนต์สามารถมีส่วนร่วมได้เร็วขึ้นโดยไม่ต้องตั้งค่า UI ด้วยตนเอง
การทำงานร่วมกันของ Git	Bitbucket Cloud และ GitLab On-Prem เชื่อมต่อกับเวิร์กโฟลว์โปรเจกต์	ทีมสามารถเก็บที่เก็บข้อมูลที่ใช้งานอยู่แล้วได้
คุณภาพในชีวิตประจำวัน	การจัดการ URL การกรองรายงาน การเติมตัวแปรอัตโนมัติ และการโหลดโปรเจกต์ดีขึ้น	ขั้นตอนการตั้งค่าและการตรวจสอบทั่วไปใช้ความสนใจน้อยลง
Docs การทดสอบ และ Specs	Schema เผยแพร่พร้อมไซต์ย่อยของ Docs ผลลัพธ์ประสิทธิภาพรายงาน P95 และ P99 และโหมด Spec เริ่มต้นได้ชัดเจนขึ้น	Schema Latency และบริบทที่เน้นสเปกเป็นหลักสามารถมองเห็นได้โดยไม่ต้องออกจากเวิร์กโฟลว์

💬 ติดต่อเรา

มีข้อเสนอแนะหรือคำถามหรือไม่? เชื่อมต่อกับวิศวกร API คนอื่นๆ และทีม Apidog ได้ที่:

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

ป.ล. สำหรับรายละเอียดทั้งหมดในการเผยแพร่ครั้งนี้ โปรดตรวจสอบ Apidog Changelog

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

ทีมงาน Apidog