Talend API Tester คือส่วนขยายของ Chrome สำหรับส่งคำขอ HTTP และตรวจสอบการตอบกลับโดยไม่ต้องออกจากเบราว์เซอร์ของคุณ เดิมชื่อ Restlet Client และนักพัฒนาหลายคนยังคงติดตั้งไว้สำหรับการตรวจสอบอย่างรวดเร็ว เนื่องจากไม่มีอะไรต้องดาวน์โหลดนอกเหนือจากส่วนขยายนี้ จัดการ REST API รองรับเมธอด HTTP ทั่วไป และสามารถจัดลำดับคำขอให้เป็นสถานการณ์ได้
คู่มือนี้แสดงวิธีใช้ Talend API Tester สำหรับงานทดสอบจริง คุณจะติดตั้ง ส่งคำขอแรก จัดระเบียบคำขอเป็นโปรเจกต์และบริการ สร้างสถานการณ์ที่รันคำขอหลายรายการตามลำดับ และเพิ่มการยืนยันเพื่อให้เครื่องมือตรวจสอบการตอบกลับให้คุณแทนที่คุณจะตรวจสอบด้วยตนเอง ตัวอย่างใช้ API สาธารณะเพื่อให้คุณสามารถทำตามได้ทันที
ติดตั้งส่วนขยายและส่งคำขอ
Talend API Tester อยู่ใน Chrome Web Store ค้นหา “Talend API Tester” แล้วคลิก Add to Chrome นอกจากนี้ยังทำงานในเบราว์เซอร์ที่ใช้ Chromium เช่น Edge และ Brave เมื่อติดตั้งแล้ว ให้เปิดจากเมนูส่วนขยาย หรือปักหมุดไว้ที่แถบเครื่องมือเพื่อการเข้าถึงอย่างรวดเร็ว
อินเทอร์เฟซมีแถบด้านข้างทางซ้ายและแผงคำขอทางขวา คลิกที่แผงคำขอแล้วคุณจะเห็นเมธอดแบบดร็อปดาวน์ ช่อง URL และแท็บสำหรับส่วนหัวและเนื้อหา
ในการส่งคำขอพื้นฐาน ให้เลือก GET และป้อนปลายทางจริง บริการ JSONPlaceholder ทำงานได้ดีสำหรับการฝึกฝน:
GET https://jsonplaceholder.typicode.com/users/1
คลิก Send การตอบกลับจะปรากฏด้านล่างพร้อมรหัสสถานะ เวลาตอบกลับ ส่วนหัว และเนื้อหา Talend API Tester จะจัดรูปแบบ JSON และ XML ให้สวยงาม ดังนั้นการตอบกลับแบบซ้อนกันจึงสามารถอ่านได้โดยไม่มีขั้นตอนเพิ่มเติม
สำหรับ POST ให้เปลี่ยนเมธอด เปิดส่วน Body และเลือกประเภทเนื้อหา เลือก application/json และป้อนข้อมูล:
{
"name": "Priya Nair",
"email": "priya.nair@example.com"
}
เพิ่มส่วนหัวในส่วน Headers สำหรับ API ที่มีการตรวจสอบสิทธิ์ ให้เพิ่มส่วนหัว Authorization พร้อมโทเค็นของคุณ เครื่องมือนี้ยังมีตัวช่วยการตรวจสอบสิทธิ์ในตัวสำหรับรูปแบบ Basic, Digest, OAuth และ Bearer หากคุณไม่ต้องการตั้งค่าส่วนหัวด้วยตนเอง
จัดระเบียบคำขอเป็นโปรเจกต์และบริการ
คำขอที่ไม่เชื่อมโยงกันสองสามรายการก็ใช้ได้สำหรับการสำรวจ API อย่างรวดเร็ว เมื่อคุณมีจำนวนมาก คุณต้องการโครงสร้าง Talend API Tester จัดระเบียบงานเป็น โปรเจกต์ และภายในโปรเจกต์เป็น บริการ
สร้างโปรเจกต์จากแถบด้านข้างและตั้งชื่อที่ชัดเจนเช่น “User API” ภายในโปรเจกต์นั้น สร้างบริการที่จัดกลุ่มปลายทางที่เกี่ยวข้อง เช่น บริการ “Users” และบริการ “Orders” บันทึกแต่ละคำขอลงในบริการที่ถูกต้อง บริการสามารถเก็บ URL พื้นฐานได้ ดังนั้นคำขอแต่ละรายการภายใต้บริการนั้นจึงต้องการเพียงแค่พาธ ซึ่งช่วยให้เป็นระเบียบ
โครงสร้างนี้มีความสำคัญด้วยเหตุผลสองประการ ประการแรก ทำให้ชุดคำขอขนาดใหญ่สามารถนำทางได้ง่ายขึ้น คุณจึงไม่ต้องเลื่อนดูการเรียกที่ไม่มีป้ายกำกับหลายสิบรายการเพื่อค้นหาสิ่งที่คุณต้องการ ประการที่สอง เป็นรากฐานสำหรับสถานการณ์ ซึ่งเราจะกล่าวถึงต่อไป เนื่องจากสถานการณ์จะอ้างอิงคำขอที่บันทึกไว้
โปรเจกต์ยังช่วยในการสลับสภาพแวดล้อม Talend API Tester รองรับตัวแปรสภาพแวดล้อม ดังนั้นคุณสามารถกำหนดตัวแปร host ที่เก็บ URL สภาพแวดล้อมทดสอบของคุณและอ้างอิงถึงมันในทุกคำขอในโปรเจกต์ด้วยตัวยึดตำแหน่ง กำหนดสภาพแวดล้อมที่สองด้วยโฮสต์การผลิต สลับไปมาระหว่างกัน และโปรเจกต์ทั้งหมดจะเปลี่ยนเป้าหมายพร้อมกัน สิ่งนี้ช่วยให้คุณไม่ต้องแก้ไข URL ด้วยตนเองและจากการยิงคำขอที่ก่อให้เกิดความเสียหายโดยไม่ตั้งใจไปยังเซิร์ฟเวอร์ที่ไม่ถูกต้อง
Talend API Tester ยังสามารถนำเข้างานที่มีอยู่ได้ รองรับ Postman collections, Swagger และ OpenAPI definitions และไฟล์ HAR หากคุณมีข้อมูลจำเพาะ API หรือการส่งออก Postman อยู่แล้ว ให้นำเข้าแทนที่จะสร้างคำขอใหม่ทุกรายการด้วยตนเอง สำหรับวิธีที่เป็นโครงสร้างในการคิดเกี่ยวกับการจัดกลุ่มการตรวจสอบ คู่มือ ตัวอย่างกรณีทดสอบ API เป็นเพื่อนคู่คิดที่มีประโยชน์
สร้างสถานการณ์เพื่อรันคำขอตามลำดับ
คำขอเดียวตอบคำถามเดียว การทดสอบจริงมักจะหมายถึงโฟลว์: สร้างเรคคอร์ด อ่านกลับ อัปเดต ลบ Talend API Tester จัดการสิ่งนี้ด้วย สถานการณ์
สถานการณ์คือรายการคำขอที่บันทึกไว้ตามลำดับ สร้างหนึ่งรายการจากแถบด้านข้าง จากนั้นเพิ่มคำขอลงไปตามลำดับที่ควรจะรัน เมื่อคุณรันสถานการณ์ เครื่องมือจะยิงแต่ละคำขอจากบนลงล่างและแสดงผลลัพธ์ของแต่ละขั้นตอน
ส่วนที่มีประโยชน์คือการส่งผ่านข้อมูลระหว่างขั้นตอน สถานการณ์สามารถจับค่าจากการตอบกลับหนึ่งและป้อนเข้าสู่คำขอในภายหลังได้ ตัวอย่างเช่น คำขอ “สร้างผู้ใช้” จะส่งคืน id ใหม่ในส่วนเนื้อหาการตอบกลับ คุณสามารถแยก id นั้นเป็นตัวแปร จากนั้นคำขอ “รับผู้ใช้” ในภายหลังจะใช้ตัวแปรใน URL นี่คือวิธีที่คุณทดสอบโฟลว์ที่มีสถานะ (stateful flows) แทนที่จะเป็นการเรียกที่แยกออกมา
สถานการณ์ยังรองรับตรรกะแบบมีเงื่อนไขและการทำซ้ำ คุณสามารถแตกแขนงตามการตอบกลับได้ ดังนั้นขั้นตอนจะทำงานก็ต่อเมื่อขั้นตอนก่อนหน้าส่งคืนสถานะเฉพาะ และคุณสามารถวนซ้ำขั้นตอนเพื่อเรียกใช้ปลายทางซ้ำๆ เมื่อรวมกับการสกัดตัวแปร สิ่งนี้ช่วยให้สถานการณ์เดียวสามารถจำลองลำดับที่สมจริงได้: ตรวจสอบสิทธิ์ สร้างเรคคอร์ด ยืนยันว่าอ่านกลับถูกต้อง แก้ไข จากนั้นล้างข้อมูลโดยการลบ การรันสถานการณ์นั้นตั้งแต่ต้นจนจบเป็นสัญญาณที่ดีกว่าการยิงแต่ละคำขอแยกกัน บทความเกี่ยวกับ สถานการณ์ทดสอบเทียบกับกรณีทดสอบ อธิบายความแตกต่างระหว่างการตรวจสอบเดียวกับโฟลว์หลายขั้นตอน ซึ่งแมปโดยตรงกับคำขอเทียบกับสถานการณ์ที่นี่
เพิ่มการยืนยันเพื่อให้เครื่องมือตรวจสอบการตอบกลับ
การรันสถานการณ์แสดงให้คุณเห็นว่ามีอะไรกลับมา การยืนยัน ทำให้เครื่องมือตัดสินใจว่าสิ่งที่กลับมานั้นถูกต้องหรือไม่ ดังนั้นคุณจึงไม่ต้องอ่านทุกการตอบกลับด้วยตนเอง
Talend API Tester ให้คุณแนบการยืนยันกับคำขอได้ เปิดคำขอที่บันทึกไว้และค้นหาส่วนการยืนยัน คุณสร้างการยืนยันผ่านแบบฟอร์มแทนที่จะเขียนโค้ด สิ่งที่พบบ่อยได้แก่:
- รหัสสถานะ เท่ากับค่าที่คาดไว้ เช่น
200หรือ201 - เวลาตอบกลับ ต่ำกว่าเกณฑ์ เช่น
500มิลลิวินาที - ฟิลด์เนื้อหา ตรงกับค่าที่คาดไว้ โดยใช้พาธในเนื้อหา JSON
- ส่วนหัว มีอยู่หรือมีค่าเฉพาะ
การยืนยันแต่ละรายการที่คุณเพิ่มจะถูกประเมินเมื่อคำขอทำงาน ไม่ว่าจะด้วยตัวเองหรือเป็นขั้นตอนในสถานการณ์ แผงผลลัพธ์จะระบุว่าการยืนยันแต่ละรายการผ่านหรือล้มเหลว รันสถานการณ์ทั้งหมดแล้วคุณจะได้ผลลัพธ์ที่ชัดเจนว่าผ่านหรือไม่ผ่านในทุกขั้นตอน ซึ่งเปลี่ยนสถานการณ์ให้เป็นการตรวจสอบการถดถอยที่สามารถทำซ้ำได้
เนื่องจากการยืนยันเป็นแบบฟอร์มมากกว่าโค้ด เครื่องมือนี้จึงเข้าถึงได้ง่ายสำหรับผู้ทดสอบที่ไม่เขียน JavaScript นั่นคือจุดแข็งที่แท้จริงสำหรับการตรวจสอบด้วยตนเองอย่างรวดเร็ว ข้อเสียคือคำศัพท์ในการยืนยันแคบกว่าเครื่องมือที่ใช้สคริปต์ หากคุณต้องการยืนยันสิ่งที่แบบฟอร์มไม่สามารถแสดงได้ เช่น ค่าที่คำนวณได้หรือเงื่อนไขที่ซับซ้อนในหลายฟิลด์ คุณจะชนเพดาน สำหรับการตรวจสอบประจำวันส่วนใหญ่ รหัสสถานะบวกกับการยืนยันฟิลด์เนื้อหาสองสามรายการก็เพียงพอแล้ว สำหรับคำแนะนำว่าอะไรควรยืนยัน โปรดดูคู่มือเชิงลึกเกี่ยวกับ การยืนยัน API
อ่านการตอบกลับอย่างถูกต้อง
ไม่ว่าคุณจะเพิ่มการยืนยันหรือไม่ คุณควรรู้วิธีอ่านการตอบกลับ มีสี่ส่วนที่สำคัญ
- รหัสสถานะ นี่คือสัญญาณแรก
2xxหมายถึงสำเร็จ,4xxหมายถึงคำขอผิดพลาด,5xxหมายถึงเซิร์ฟเวอร์ล้มเหลว การอ้างอิงเช่นคู่มือเกี่ยวกับ รหัสสถานะ HTTP ที่ REST API ควรใช้ ช่วยให้คุณตีความรหัสที่ไม่ชัดเจน - เวลาตอบกลับ Talend API Tester รายงานว่าคำขอใช้เวลานานเท่าใด ปลายทางที่ช้าเป็นปัญหาแม้ว่าจะส่งคืนข้อมูลที่ถูกต้องก็ตาม
- ส่วนหัว ส่วนหัวมี
Content-Type, คำสั่งแคช, ข้อมูลจำกัดอัตรา และรายละเอียด CORS มักจะอธิบายพฤติกรรมที่เนื้อหาไม่ได้บอก - เนื้อหา ข้อมูลจริง ซึ่งมักจะเป็น JSON หรือ XML ตรวจสอบว่าฟิลด์ ประเภท และค่าเป็นไปตามสัญญาที่กำหนดไว้
การอ่านทั้งสี่ส่วนร่วมกันจะบอกคุณว่า API มีสุขภาพดีหรือไม่ ไม่ใช่แค่ว่ามันตอบกลับมาหรือไม่
เมื่อส่วนขยาย Chrome ไม่เพียงพอ
Talend API Tester สะดวกและรวดเร็วสำหรับการตรวจสอบบนเบราว์เซอร์ ข้อจำกัดของมันจะปรากฏขึ้นเมื่อปริมาณงานเพิ่มขึ้น มันผูกติดอยู่กับ Chrome ดังนั้นจึงไม่สามารถรันแบบ Headless ใน CI pipeline ได้ ระบบการยืนยันของมันแข็งแกร่งแต่พื้นฐานเมื่อเทียบกับแพลตฟอร์มการทดสอบเต็มรูปแบบ และมันไม่ครอบคลุมการออกแบบ API, การจำลอง (mocking) หรือเอกสารประกอบ ดังนั้นมันจึงเป็นเครื่องมือหนึ่งในหลายๆ เครื่องมือมากกว่าจะเป็นพื้นที่ทำงานเดียว
Apidog เป็นแพลตฟอร์ม API แบบ All-in-one ที่เติมเต็มช่องว่างเหล่านั้น เป็นแอปพลิเคชันแบบสแตนด์อโลนแทนที่จะเป็นส่วนขยายเบราว์เซอร์ สามารถนำเข้า Postman, OpenAPI และรูปแบบอื่นๆ ได้เหมือนกับ Talend API Tester และเพิ่มตัวสร้างการยืนยันแบบเห็นภาพ, เซิร์ฟเวอร์จำลอง, สถานการณ์การทดสอบอัตโนมัติ และเอกสารประกอบที่สร้างขึ้นในโปรเจกต์เดียว เนื่องจากสเปกและชุดทดสอบใช้แหล่งความจริงเดียวกัน พวกเขาจึงไม่แยกออกจากกัน คุณสามารถ ดาวน์โหลด Apidog และนำเข้าคำขอที่มีอยู่ของคุณเพื่อเปรียบเทียบ สำหรับการสำรวจตัวเลือกที่กว้างขึ้น การเปรียบเทียบ เครื่องมือทดสอบ API ออนไลน์ฟรี เป็นจุดเริ่มต้นที่ดี
Talend API Tester ยังคงเป็นตัวเลือกที่ดีสำหรับการตรวจสอบที่รวดเร็วและอยู่ในเบราว์เซอร์ เลือกเครื่องมือให้เหมาะสมกับขนาดและขั้นตอนของงานทดสอบของคุณ
คำถามที่พบบ่อย
Talend API Tester เหมือนกับ Restlet Client หรือไม่?
ใช่ Talend API Tester เป็นเวอร์ชันที่เปลี่ยนชื่อของเครื่องมือที่เคยเรียกว่า Restlet Client ฟังก์ชันการทำงานยังคงเป็นสายเลือดเดียวกัน: ส่วนขยาย Chrome สำหรับส่งคำขอ HTTP, จัดระเบียบ และรันสถานการณ์พร้อมการยืนยัน
Talend API Tester ฟรีหรือไม่?
มีเวอร์ชันฟรีให้ใช้งานใน Chrome Web Store ซึ่งครอบคลุมการส่งคำขอ, จัดระเบียบเป็นโปรเจกต์ และสร้างสถานการณ์พร้อมการยืนยัน เวอร์ชันที่ต้องชำระเงินในอดีตได้เพิ่มคุณสมบัติสำหรับทีมและขีดจำกัดที่ใหญ่ขึ้น เวอร์ชันฟรีเพียงพอสำหรับงานทดสอบส่วนบุคคลส่วนใหญ่
Talend API Tester สามารถรันการทดสอบใน CI/CD ได้หรือไม่?
ไม่โดยตรง เป็นส่วนขยาย Chrome และทำงานภายในเบราว์เซอร์ ดังนั้นจึงไม่สามารถรันแบบ Headless ใน Pipeline ได้ สำหรับการทดสอบอัตโนมัติที่รันทุกครั้งที่มีการคอมมิท คุณต้องมีเครื่องมือที่มีตัวรันบรรทัดคำสั่ง คู่มือเกี่ยวกับ การทำให้การทดสอบ API เป็นอัตโนมัติใน CI/CD ครอบคลุมลักษณะของการตั้งค่าดังกล่าว
Talend API Tester สามารถนำเข้ารูปแบบใดได้บ้าง?
สามารถนำเข้า Postman collections, Swagger และ OpenAPI definitions และไฟล์ HAR สิ่งนี้ช่วยให้คุณสามารถนำเข้าข้อมูลจำเพาะ API หรือการส่งออกที่มีอยู่แทนที่จะสร้างคำขอใหม่ด้วยตนเองทุกรายการ
สถานการณ์แตกต่างจากคำขอเดียวอย่างไร?
คำขอเดียวจะส่งการเรียก HTTP หนึ่งครั้งและแสดงการตอบกลับหนึ่งรายการ สถานการณ์คือรายการคำขอตามลำดับที่รันตามลำดับ และสามารถส่งผ่านข้อมูลที่ดึงมาจากการตอบกลับหนึ่งไปยังคำขอในภายหลังได้ สถานการณ์ทดสอบโฟลว์หลายขั้นตอน เช่น สร้างแล้วอ่านแล้วลบ ในขณะที่คำขอเดียวจะทดสอบการเรียกที่แยกออกมาหนึ่งครั้ง