Persisted Queries

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

Persisted queries คือ GraphQL queries ทั่วไป แต่จะถูกจัดเก็บไว้บนเซิร์ฟเวอร์และเข้าถึงได้ผ่าน URL เฉพาะของตัวเอง จึงจำลองการทำงานของ REST endpoint ซึ่งให้ข้อดีจาก API ทั้งสองรูปแบบ ในขณะที่หลีกเลี่ยงข้อเสียของแต่ละรูปแบบ:

ข้อดี	ข้อเสีย
✅ เข้าถึงได้ผ่าน `GET` หรือ `POST`	~~❌ เข้าถึงได้เฉพาะผ่าน `POST` เท่านั้น~~
✅ สามารถ cache ได้บนเซิร์ฟเวอร์หรือ CDN	~~❌ ต้องเพิ่ม layer พิเศษฝั่ง client เพื่อการ cache~~
✅ ปลอดภัย: เปิดเผยเฉพาะข้อมูลที่ตั้งใจไว้	~~❌ ข้อมูลเปิดเผยต่อทุกคน รวมถึงผู้ไม่ประสงค์ดี~~
✅ ไม่มีการดึงข้อมูลน้อยเกินหรือมากเกิน ข้อมูลทั้งหมดดึงได้ในคำขอเดียว	~~❌ อาจช้า เนื่องจากแอปพลิเคชันอาจต้องใช้หลายคำขอเพื่อดึงข้อมูลทั้งหมด~~
✅ รองรับการพัฒนา project อย่างรวดเร็ว	~~❌ การสร้าง endpoint ทั้งหมดนั้นน่าเบื่อหน่าย~~
✅ รองรับการทำ self-documentation	~~❌ การจัดทำเอกสารเป็นสิ่งจำเป็น~~
✅ ให้ client สร้างและเผยแพร่ query ได้	~~❌ การเผยแพร่ endpoint ต้องทำผ่านโค้ด~~