อาร์กิวเมนต์สำหรับคำนามเอกพจน์ในการตั้งชื่อทรัพยากร RESTful API คืออะไร


12

ฉันเข้าใจว่าเมื่อตั้งชื่อ RESTful URI เป็นที่ยอมรับกันโดยทั่วไปในการใช้คำพหูพจน์เพื่อแสดงชุดของทรัพยากร ฉันอยากรู้ว่าอาร์กิวเมนต์สำหรับการใช้คำนามเอกพจน์แทน


อาจจะเป็นเพราะไม่ใช่ทุกอย่างที่เป็นของสะสม?
jwenting

นั่นเป็นสิ่งที่ทรัพยากรเดี่ยวจะเข้ามาเล่น?
ชัดเจน

คำตอบ:


12

ทรัพยากรบางอย่างมีเพียงรายการเดียว ตัวอย่างที่ดีคือทุกสิ่งที่คุณไม่ต้องการ ID เพื่อค้นหาข้อมูลที่จะแสดง ตัวอย่างที่พบบ่อยมากจะเป็นทรัพยากรการเข้าสู่ระบบ คุณมี (จากผู้ใช้และมุมมองเบราว์เซอร์) เพียงเข้าสู่ระบบเดียว คุณสามารถสร้างมันได้คุณสามารถทำลายมันได้ แต่คุณจะไม่มีการกระทำของดัชนีที่มีการเข้าสู่ระบบหลายแบบให้เลือก

ตัวอย่างที่คล้ายกันอาจเป็นหน้าสแตติกส่วนใหญ่เช่นข้อมูล บริษัท สำนักพิมพ์แบบฟอร์มการติดต่อและสิ่งที่คล้ายกันซึ่งแสดงเพียงรายการเดียวหรืออนุญาตให้สร้างการกระทำเพียงครั้งเดียวเท่านั้น

มันอาจเป็นเรื่องของการสนทนาหากใช้คำนามเอกพจน์จริงๆเพิ่มมากในการอ่านรหัส


5

เพราะ:

  1. กฎพหูพจน์ภาษาอังกฤษเช่น "เชอร์รี่" ไม่ใช่สิ่งที่ดีที่สุดที่คิดในขณะที่พัฒนา API โดยเฉพาะอย่างยิ่งเมื่อภาษาอังกฤษไม่ใช่ภาษาแม่ของคุณ
  2. บางครั้งคุณต้องการสร้างจุดสิ้นสุดจากตัวแบบซึ่งมักจะเป็นเอกพจน์ มันไม่ได้เล่นอย่างดีกับข้างต้น
  3. อาร์กิวเมนต์ "โดยปกติคุณจะเริ่มสืบค้นด้วย Get to display list" ไม่ได้อ้างถึงกรณีการใช้งานจริงใด ๆ และคุณจะต้องค้นหารายการเดียวให้มากที่สุดและมากกว่ารายการ
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.