การใช้งาน

เราใช้ Neo4jGraphQL เป็นเครื่องมือหลักในการจัดการข้อมูล API ของเราอยู่ในมาตรฐาน GraphQL ซึ่งสามารถเรียกใช้หรือเข้าไปทดลองสร้าง Query ต่างๆ ได้ที่ https://politigraph.wevis.info/graphql

การยืนยันตัวตน

ข้อมูลส่วนใหญ่จาก Politigraph API เป็นแบบเปิดให้เข้าถึงโดยสาธารณะ ไม่จำเป็นต้องยืนยันตัวตน ยกเว้น

• ข้อมูลที่มี Field publish_status และไม่ได้มีค่าเป็น PUBLISHED จะไม่ถูกซ่อนจาก Response เนื่องจากอยู่ระหว่างการตรวจสอบและยังไม่พร้อมเปิดเผย
• การ Mutate ผ่าน GraphQL ใดๆ เราป้องกันไม่ให้คนภายนอกแก้ไขข้อมูลบนระบบของเรา

ทั้งสองข้อสงวนสิทธ์การเข้าถึงให้กับทีมดูแลระบบของ WeVis เท่านั้น

การจำกัดการใช้งาน API

เพื่อป้องกัน API ให้สามารถรองรับผู้ใช้งานได้ดีที่สุด เราจำกัดการใช้งาน API ดังนี้:

• การเรียกใช้ API สูงสุดอยู่ที่ 30 Requests ต่อ 10 วินาที
• จำนวน Batched Request สูงสุดอยู่ที่ 5 Operations ต่อ Batched Request
• จำนวน Alias: 10 ต่อ Operation
• ความลึก: 10 ระดับของ Operation ที่ซ้อนกัน
• จำนวน Token: 1,000 Token ต่อ Request

จะได้รับ Error Response หากใช้งานเกินข้อกำหนด

การจำกัดจำนวน Node

ข้อมูลบางประเภท ได้แก่ คน (People) และ การลงคะแนนรายบุคคล (Vote) เป็นข้อมูลที่มี Node อยู่จำนวนมากในระบบ เราจำเป็นต้องจำกัดจำนวน Node ที่จะส่งกลับมายังผู้ใช้ ไม่เกิน 1,000 Node ต่อการ Query 1 ครั้ง หากต้องการเรียกข้อมูลมากกว่าจำนวนที่จำกัดไว้ อ่านเพิ่มเติมเกี่ยวกับการใช้ Pagination บน GraphQL

การอนุญาตใช้งาน (License)

ด้านข้อมูล ทีมงานตั้งใจเปิดข้อมูลเป็น Open Data ภายใต้เงื่อนไข Attribution-NonCommercial 4.0 International ซึ่งหมายถึง สามารถนำข้อมูลไปใช้ ดัดแปลง ต่อยอดได้ แต่ห้ามนำไปใช้ทางการค้าหรือแสวงหาผลกำไรจากผลงาน และต้องให้เครดิตกับ WeVis

ด้าน Source Code ทางทีมมีความตั้งใจที่พัฒนาทุกโปรเจ็กต์ให้เป็น Open Source ภายใต้เงื่อนไข Attribution-NonCommercial-ShareAlike 4.0 International ซึ่งหมายถึง สามารถนำผลงานไปใช้ ดัดแปลง ต่อยอดได้ แต่ห้ามนำไปใช้ทางการค้าหรือแสวงหาผลกำไรจากผลงาน และต้องแจ้งทราบและให้เครดิตกับเจ้าของผลงาน โดยที่ผลงานที่เกิดขึ้นมาจะต้องอยู่ภายใต้เงื่อนไขแบบเดียวกันกับใบอนุญาต Creative Commons ของต้นฉบับ โดย WeVis Ltd. และ Punch Up Ltd. เป็น ผู้อนุญาต (licensor) ร่วมกัน