เอ็นด์พอยต์ REST สมัยใหม่, GraphQL-over-GET และ webhook มักจะรวมอาร์เรย์ที่มีหลายค่า ออบเจ็กต์ตัวกรองที่ซ้อนกัน เคอร์เซอร์แบ่งหน้าแบบ Base64 และวลีค้นหาที่เข้ารหัส URL ไว้ใน Query String เดียว หรือในบอดี้ของคำขอแบบ application/x-www-form-urlencoded การตรวจสอบหรือแก้ไขเพย์โหลดเหล่านั้นในรูปแบบสตริงดิบยาวๆ มักนำไปสู่ปัญหาอักขระหลีก %26 เสียหายหรือวงเล็บเหลี่ยมไม่ครบคู่
ลองพิจารณาคิวรีสำหรับการค้นหาผ่าน API ที่ผสมผสานทั้งช่องว่างที่เข้ารหัสด้วย +, คีย์ที่ซ้ำกัน, ตัวกรองวงเล็บเหลี่ยมซ้อนกัน, เคอร์เซอร์แบ่งหน้า Base64 ที่มีเครื่องหมาย = ซึ่งเข้ารหัสเปอร์เซ็นต์ไว้ และพารามิเตอร์แฟล็กแบบไม่มีค่า:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
เมื่อนำสตริงนี้มาแยกวิเคราะห์ จะได้ผลลัพธ์เป็นโครงสร้าง JSON ที่อ่านเข้าใจง่ายและมีระเบียบชัดเจนทันที:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
เหตุใดการแยกตัวคั่นจึงต้องทำก่อนการถอดรหัสเปอร์เซ็นต์
สังเกตว่า cursor=eyJpZCI6NDIwfQ%3D%3D ถูกถอดรหัสออกมาเป็น "eyJpZCI6NDIwfQ==" ได้อย่างถูกต้อง เครื่องมือจะแบ่งสตริงดิบด้วย & เป็นอันดับแรก แยกแต่ละคู่ด้วยเครื่องหมาย = ตัวแรกสุด แล้วจึงค่อยถอดรหัสลำดับ + และ %XX หากสคริปต์ทั่วไปเรียกใช้ decodeURIComponent() กับ Query String ทั้งหมดก่อนที่จะแยกด้วย & และ = ค่าพารามิเตอร์ใดๆ ที่มีเครื่องหมายแอมเพอร์แซนด์ที่เข้ารหัสไว้ (R%26D -> R&D) จะถูกตัดแบ่งออกเป็นสองพารามิเตอร์ที่ผิดพลาดทันที
เนื่องจากมุมมอง JSON และตาราง key-value ซิงโครไนซ์กันแบบสองทิศทาง คุณจึงสามารถวางออบเจ็กต์ตัวกรอง JSON จากโค้ดแอปพลิเคชันของคุณ แล้วแปลงออกมาเป็น Query String ที่ escape อย่างถูกต้องเพื่อนำไปใช้ส่งคำขอ HTTP ได้ทันที