Pertanyaan yang diberi tag api-design

301
Apa praktik terbaik untuk sumber daya bersarang REST?

Sejauh yang saya tahu setiap sumber daya individu harus hanya memiliki satu jalur kanonik . Jadi, dalam contoh berikut, apa yang akan menjadi pola URL yang baik? Ambil contoh, perwakilan dari Perusahaan. Dalam contoh hipotetis ini, setiap perusahaan memiliki 0 atau lebih departemen dan...

288
Praktik terbaik pagination API

Saya membutuhkan bantuan menangani case edge yang aneh dengan API paginasi yang saya bangun. Seperti banyak API, ini memberikan hasil yang besar. Jika Anda query / foos, Anda akan mendapatkan 100 hasil (mis. Foo # 1-100), dan tautan ke / foos? Page = 2 yang akan mengembalikan foo #...

239
Mengapa Java Streaming sekali saja?

Tidak seperti C # IEnumerable, di mana pipa eksekusi dapat dieksekusi sebanyak yang kita inginkan, di Jawa stream dapat 'diulang' hanya sekali. Setiap panggilan ke operasi terminal menutup aliran, menjadikannya tidak dapat digunakan. 'Fitur' ini menghilangkan banyak daya. Saya membayangkan alasan...

97
GB Inggris, atau Inggris AS?

Jika Anda memiliki API, dan Anda adalah pengembang yang berbasis di Inggris dengan audiens yang sangat internasional, sebaiknya API Anda setColour() atau setColor() (Untuk mengambil satu kata sebagai contoh sederhana.) Insinyur yang berbasis di Inggris seringkali cukup defensif tentang...