รัน API Collection จาก Command Line ด้วย Bruno CLI

ภาพรวม

Bruno CLI คือทางลัดสำหรับเอา API Collection ที่ทีมมีอยู่แล้ว ไปรันจาก command line ได้ทันที 🚀

ถ้า Bruno Desktop คือที่ที่เราออกแบบและลองยิง request Bruno CLI คือชิ้นที่ทำให้ request เหล่านั้นกลายเป็นงานอัตโนมัติ เช่น smoke test, regression test หรือเช็ก staging ก่อนปล่อยงาน

ภาพที่ควรจำ เราไม่ได้เปิดแอปแล้วกดทีละปุ่ม แต่สั่งให้ collection ทั้งชุดวิ่งจาก terminal แล้วดูผลผ่าน exit code ได้เลย

คำสั่งพื้นฐานที่ทีมมักเริ่มใช้

bru run ./bruno --env staging

คำสั่งนี้บอกว่าให้รัน collection ในโฟลเดอร์ ./bruno โดยใช้ environment ชื่อ staging ถ้า request สำคัญล้มเหลว กระบวนการถัดไปก็หยุดได้

ทำไม command line ถึงสำคัญ เพราะมันเอา API test ไปอยู่ใน workflow เดียวกับ dev tools อื่น ๆ ได้ เช่น npm script, Makefile, GitHub Actions, GitLab CI หรือ pre-deploy script

กรณีที่เหมาะมาก ทีม backend เพิ่งแก้ endpoint ใหม่ ก่อน merge หรือก่อน deploy ให้รัน collection ชุดเล็กที่ครอบ login, create order, get profile, health check ถ้าทุกตัวผ่าน ค่อยไปขั้นถัดไป

ข้อที่ต้องจัดก่อนเริ่มใช้ collection ต้องไม่ผูกกับเครื่องคนใดคนหนึ่ง ควรเก็บใน Git, ตั้งชื่อ folder อ่านง่าย, แยก environment และอย่าใส่ token จริงลงไฟล์

ความเข้าใจผิดที่เจอบ่อย Bruno CLI ไม่ได้มีไว้แทน unit test ทั้งหมด มันเหมาะกับการเช็ก API flow และ contract จากมุมมองผู้ใช้งานระบบมากกว่า

ถ้าอยากเริ่มแบบไม่เสี่ยง เริ่มจาก collection 5 request ที่สำคัญที่สุดก่อน เช่น login, refresh token, list products, create order, get order detail แล้วค่อยขยายเป็นชุด test ใหญ่เมื่อทีมเริ่มเชื่อใจ workflow นี้แล้ว

สรุปจำง่าย Bruno CLI คือสะพานจาก “กด API ในแอป” ไปสู่ “ตรวจ API แบบอัตโนมัติ” ถ้าทีมมี collection อยู่แล้ว การเพิ่ม CLI คือก้าวเล็กที่ทำให้ API workflow จริงจังขึ้นมาก ✅

แนวทางนำไปใช้

• นำแนวคิดจากโพสต์นี้ไปทดลองกับงานจริงของคุณ
• แยกเป็นขั้นตอนเล็ก ๆ แล้วทำทีละส่วน
• บันทึกผลลัพธ์และสิ่งที่เรียนรู้เพื่อต่อยอด

สรุป

นำ collection ที่ทีมเก็บใน Git มารันแบบอัตโนมัติผ่าน Bruno CLI พร้อม environment และ assertion เพื่อใช้ตรวจ API ใน local workflow หรือ CI pipeline