คำถามติดแท็ก restful-architecture

เรากำลังพัฒนาเซิร์ฟเวอร์ด้วย REST API ซึ่งยอมรับและตอบกลับด้วย JSON ปัญหาคือถ้าคุณต้องการอัปโหลดภาพจากลูกค้าไปยังเซิร์ฟเวอร์ หมายเหตุ: และฉันกำลังพูดถึงกรณีใช้งานที่เอนทิตี (ผู้ใช้) สามารถมีหลายไฟล์ (carPhoto, licensePhoto) และยังมีคุณสมบัติอื่น ๆ (ชื่ออีเมล ... ) แต่เมื่อคุณสร้างผู้ใช้ใหม่คุณไม่ต้อง ไม่ต้องส่งภาพเหล่านี้พวกเขาจะถูกเพิ่มหลังจากกระบวนการลงทะเบียน แนวทางแก้ไขที่ฉันทราบ แต่แต่ละข้อมีข้อบกพร่อง 1. ใช้ multipart / form-data แทน JSON ดี : คำขอ POST และ PUT นั้นสงบที่สุดเท่าที่จะเป็นไปได้พวกเขาสามารถมีอินพุตข้อความพร้อมไฟล์ได้ ข้อเสีย : มันไม่ใช่ JSON อีกต่อไปซึ่งง่ายต่อการทดสอบการดีบักและอื่น ๆ เปรียบเทียบกับหลายส่วน / แบบฟอร์มข้อมูล 2. อนุญาตให้อัปเดตไฟล์แยกต่างหาก คำขอ POST สำหรับการสร้างผู้ใช้ใหม่ไม่อนุญาตให้เพิ่มรูปภาพ (ซึ่งเป็นสิ่งที่เราใช้ในกรณีที่ฉันพูดตอนเริ่มต้น) …

198 json  rest  file-upload  restful-architecture 

โปรดทราบว่าฉันมีความเข้าใจพื้นฐานเกี่ยวกับส่วนที่เหลือ สมมติว่าฉันมี URL นี้: http://api.animals.com/v1/dogs/1/ และตอนนี้ฉันต้องการให้เซิร์ฟเวอร์สร้างสุนัขเห่า เฉพาะเซิร์ฟเวอร์เท่านั้นที่รู้วิธีการทำเช่นนี้ สมมติว่าฉันต้องการให้มันทำงานในงาน CRON ที่ทำให้สุนัขเห่าทุก ๆ 10 นาทีตลอดชั่วนิรันดร์ การโทรนั้นมีลักษณะอย่างไร ฉันต้องการทำสิ่งนี้: คำขอ URL: ACTION http://api.animals.com/v1/dogs/1/ ในเนื้อหาคำขอ: {"action":"bark"} ก่อนที่คุณจะโกรธฉันที่ทำวิธี HTTP ของฉันเองช่วยฉันออกมาและให้แนวคิดที่ดีกว่าเกี่ยวกับวิธีที่ฉันควรเรียกใช้วิธีฝั่งเซิร์ฟเวอร์แบบ RESTful :) แก้ไขเพื่อความชัดเจน ชี้แจงเพิ่มเติมเกี่ยวกับสิ่งที่ "เปลือกไม้" วิธีการ นี่คือตัวเลือกบางอย่างที่อาจทำให้การเรียก API ที่มีโครงสร้างแตกต่างกัน: เรือสำเภาเพียงส่งอีเมลไปที่ dog.email และบันทึกสิ่งใด bark ส่งอีเมลไปที่ dog.email และการเพิ่มขึ้น dog.barkCount 1 bark สร้างเร็กคอร์ด "bark" ใหม่ที่มีการบันทึก bark.timestamp เมื่อ bark เกิดขึ้น …

142 api  rest  url  api-design  restful-architecture 

ฉันต้องการให้ RESTful API ของฉันสามารถคาดเดาได้มาก แนวทางปฏิบัติที่ดีที่สุดในการตัดสินใจว่าเมื่อใดควรแบ่งกลุ่มข้อมูลโดยใช้ URI แทนที่จะใช้พารามิเตอร์แบบสอบถาม มันสมเหตุสมผลแล้วสำหรับฉันที่พารามิเตอร์ระบบที่รองรับการแบ่งหน้าการเรียงลำดับและการจัดกลุ่มอยู่หลังเครื่องหมาย '?' แต่ช่องต่างๆเช่น "สถานะ" และ "ภูมิภาค" หรือแอตทริบิวต์อื่น ๆ ที่แบ่งกลุ่มคอลเล็กชันของคุณล่ะ ถ้าสิ่งเหล่านี้จะต้องเป็นพารามิเตอร์การสืบค้นด้วยเช่นกันกฎง่ายๆในการรู้ว่าเมื่อใดควรใช้พา ธ พารามิเตอร์?

142 rest  spring-mvc  restful-url  restful-architecture  api-design 

ฉันเคยได้ยินทั้ง "ทรัพยากร" และ "ปลายทาง" เพื่ออ้างถึงสิ่งเดียวกัน ดูเหมือนว่าทรัพยากรเป็นคำที่ใหม่กว่า ความแตกต่างระหว่างพวกเขาคืออะไร? "ทรัพยากร" แสดงถึงการออกแบบที่สงบเงียบหรือไม่?

139 rest  api  uri  restful-architecture  endpoint