ตัวขยาย URI Template
ขยาย URI Template ตามมาตรฐาน RFC 6570 ให้เป็น URL สุดท้ายในเบราว์เซอร์ รองรับ query string, path segment, fragment, list และ explode modifier
Loading tool...
ตัวขยาย URI Template คืออะไร?
ตัวขยาย URI Template คือเครื่องมือออนไลน์ฟรีที่ implement มาตรฐาน RFC 6570 ของ IETF สำหรับ URL แบบมีพารามิเตอร์ แทนที่จะประกอบ query string เองแล้วกังวลเรื่อง encoding คุณเพียงเขียน template เดียว กรอกตารางตัวแปร แล้วคัดลอก URL ที่เสร็จสมบูรณ์ — ผลลัพธ์ตรงกับที่ตัวขยายฝั่ง server สร้างทุกประการ
ประโยชน์หลัก
- ผลลัพธ์ถูกต้องตาม RFC 6570 แน่นอน โดยผ่านการทดสอบเทียบกับ test vector อย่างเป็นทางการ
- เห็นผลลัพธ์ทันทีขณะปรับแก้ design ของ template
- มีระบบเตือนเมื่อ template ต้องการตัวแปรที่ยังไม่ได้กรอกค่า
- ไม่ต้องสมัครสมาชิก ไม่ต้องอัปโหลด ไม่มี server — ปลอดภัยกับงาน API ส่วนตัว
กรณีการใช้งาน
- •ต้นแบบ URL endpoint ของ REST API ก่อนเขียนโค้ดฝั่ง client
- •ตรวจว่า path template ของ OpenAPI และ pattern ของ Spring UriTemplate ขยายผลลัพธ์ออกมาอย่างไร
- •สร้างตัวอย่างในเอกสารที่เป็น URL จริง โดย encode ถูกต้อง
- •สร้าง URL สำหรับทดสอบ QA ด้วยชุดพารามิเตอร์หลากหลายรูปแบบ
วิธีใช้ตัวขยาย URI Template
- กรอก template: วางหรือพิมพ์ template ตาม RFC 6570 เช่น https://api.example.com/users/{id}{?fields} ลงในช่อง template หรือกดชิปตัวอย่างด้านล่างเพื่อโหลดแบบสำเร็จรูป
- กรอกตารางตัวแปร: แต่ละแถวคือหนึ่งตัวแปร เลือกชนิด (string, list หรือ map) แล้วใส่ค่า โดย list คั่นด้วย comma และ map อยู่ในรูป key=value
- ตรวจผลลัพธ์แบบเรียลไทม์: URI ที่ขยายแล้วจะอัปเดตทันทีด้านล่าง หาก template อ้างถึงตัวแปรที่ไม่มีแถว ระบบจะเตือนชื่อตัวแปรที่ขาดหาย
- คัดลอกผลลัพธ์: กดปุ่มคัดลอกเพื่อนำ URL สุดท้ายที่ encode แล้วไปใช้ในเอกสาร, ชุดทดสอบ หรือ HTTP client ได้ทันที
คุณสมบัติหลัก
- รองรับ RFC 6570 ระดับ Level 1-4 ครบ: operator ทั้ง 7 แบบ รวม reserved expansion และ query continuation
- ตารางตัวแปรรองรับค่าแบบ string, list และ map พร้อม explode และ prefix modifier
- ขยายผลลัพธ์แบบเรียลไทม์ขณะพิมพ์ พร้อมเตือนตัวแปรที่ยังไม่ได้กำหนดค่าก่อนนำไปใช้จริง
- จัดการ percent-encoding ถูกต้องตรงตาม RFC โดยผ่านการทดสอบเทียบกับ test vector อย่างเป็นทางการ
- template ตัวอย่างสำหรับ pattern ที่พบบ่อยของ REST API คลิกเดียวเริ่มใช้ได้เลย
- ทำงานฝั่ง client 100%: ใช้ offline ได้ และ design ของ API ส่วนตัวไม่หลุดออกจากเครื่อง
คำถามที่พบบ่อย
URI Template (RFC 6570) คืออะไร?
URI Template คือข้อความตามมาตรฐานที่มีตัวแปรอยู่ใน curly braces เช่น https://api.example.com/users/{id}{?fields} โดย RFC 6570 กำหนดวิธีแทนค่าและ percent-encode ตัวแปรให้กลายเป็น URL สุดท้ายอย่างไร มาตรฐานนี้ถูกใช้โดย OpenAPI, Spring และ HTTP client จำนวนมาก
ต่างกันอย่างไรระหว่าง {var} กับ {+var}?
simple expansion {var} จะ percent-encode อักขระ reserved เช่น slash ให้หมด ส่วน reserved expansion {+var} จะคง slash, question mark และ colon ไว้ตามเดิม นั่นคือเหตุผลที่ {+path} กับค่า /foo/bar ได้ผลลัพธ์ /foo/bar ไม่ใช่ %2Ffoo%2Fbar
explode modifier (*) ทำอะไร?
explode modifier จะกระจาย list หรือ map ออกเป็นส่วนย่อยแยกกัน เช่น {?tags*} กับ tags=dev,web จะได้ ?tags=dev&tags=web แทนที่จะต่อด้วย comma เป็น ?tags=dev,web ซึ่งเป็นรูปแบบที่ API ส่วนใหญ่คาดหวังสำหรับ query parameter ที่ซ้ำกัน
ข้อมูลของเราถูกส่งออกนอกเบราว์เซอร์ไหม?
ไม่ ตัวขยาย RFC 6570 ทั้งหมดทำงานด้วย JavaScript ในเบราว์เซอร์ของคุณล้วน ๆ ไม่มีการเรียก server ไม่มีการอัปโหลด และใช้งาน offline ได้ design ของ API ภายในจึงเป็นส่วนตัวอยู่เสมอ