Saya pikir salah satu titik sakit terbesar dalam bekerja dengan layanan microsoft adalah memastikan bahwa API didokumentasikan dengan baik dan API tidak mengubah perilaku mereka tanpa mempengaruhi aplikasi hilir. Masalah ini menjadi bertambah ketika Anda memiliki banyak layanan yang saling...
Saya melihat bahwa semakin banyak API baru menggunakan token halaman untuk memungkinkan pengguna berpindah antar halaman hasil yang mengandung banyak item. Namun dari sudut pandang desainer API, saya tidak jelas tentang apa manfaat menggunakan token jika dibandingkan dengan membiarkan pengguna...
Di masa lalu, saya menggunakan cara standar untuk menambahkan @Deprecatedanotasi ke metode API yang akan dihapus di versi yang lebih baru. Sekarang saya sedang mempersiapkan versi utama untuk perpustakaan, dengan banyak bagian API dihapus dan diganti namanya. Untuk membuat transisi lebih mudah...
Pertanyaan ini telah mengganggu saya selama beberapa hari, dan rasanya seperti beberapa praktik yang saling bertentangan. Contoh Iterasi 1 public class FooDao : IFooDao { private IFooConnection fooConnection; private IBarConnection barConnection; public FooDao(IFooConnection fooConnection,...
Ketika mendesain Layanan Web RESTful haruskah API dirancang untuk bekerja ID untuk Strings untuk nilai-nilai yang diteruskan bolak-balik antara server? Berikut ini sebuah contoh: Katakanlah saya memiliki sumber daya Karyawan, yang memiliki status dan atribut gender. Dalam Status database dan Jenis...
Dari komentar Roy Fielding pada artikelnya sendiri mengutuk apis REST palsu : API yang benar-benar tenang seperti hypertext. Setiap unit informasi yang dapat dialamatkan membawa alamat, baik secara eksplisit (misalnya, atribut tautan dan id) atau secara implisit (misalnya, diturunkan dari...
Dalam aplikasi utama REST API yang mencakup beberapa domain terkait, apakah lebih masuk akal untuk membagi sumber daya menjadi 'area' berdasarkan domain bisnis tempat mereka berada atau lebih baik mempertahankan model tunggal? Misalnya, ada sub-domain 'Penjualan' dan 'Persediaan'. Pengguna sistem...