«api-design» etiketlenmiş sorular

Uygulama Programlama Arayüzü (API) Tasarımı, genel amaçlı veya genel kullanıma yönelik kütüphaneler oluşturmak için en iyi uygulamaları tartışır.



2
Mevcut bir öğeyi REST API'sindeki bir koleksiyona eklemek için en iyi kalıp hangisidir?
Pragmatik bir REST API tasarlıyorum ve bir koleksiyona mevcut varlıkları nasıl en iyi şekilde ekleyeceğime biraz şaşırdım. Etki alanı modelim, Siteler koleksiyonuna sahip bir Proje içeriyor. Bu katı bir çoktan çoğa ilişkidir ve ilişkiyi açıkça modelleyen bir varlık yaratmaya ihtiyacım yok (yani ProjectSite). API’m, tüketicilerin bir Projeye varolan bir Site …
23 rest  api-design 

5
Başarısız olduğunda başarılı ve istisna atarken, true / false vs.
Bir dosya yükleyen bir işlev olan bir API yapıyorum. Bu işlev, dosya doğru yüklendiyse hiçbir şey döndürmez / geçersiz kılar ve bir sorun olduğunda bir istisna atar. Neden bir istisna ve sadece yanlış değil? Çünkü bir istisna içerisinde başarısızlık sebebini belirleyebilirim (bağlantı yok, eksik dosya adı, yanlış şifre, eksik dosya …

2
Bir API sadece kod bakarak ne yaptığını her zaman bilmek gerekir?
Son zamanlarda kendi API'mı geliştiriyorum ve API tasarımına bu kadar ilgi duyduğumda, API tasarımımı nasıl geliştirebileceğimi çok merak ettim. Birkaç kez ortaya çıkan bir yönü (API'mın kullanıcıları tarafından değil, konu hakkındaki gözlemli tartışmamda): API'yı ne yaptığını çağıran koda bakarak bilmelisiniz . Örneğin , söylem repo için GitHub'daki bu tartışmaya bakın …


4
Java koleksiyon API'larının neden son bir yöntemi yok? [kapalı]
Kapalı . Bu soru görüş temelli . Şu anda cevapları kabul etmiyor. Bu soruyu geliştirmek ister misiniz? Bu yayını düzenleyerek gerçekler ve alıntılarla yanıtlanabilmesi için soruyu güncelleyin . 5 yıl önce kapalı . Bu, java.util.List gibi sıralı koleksiyonlar içindir. Dil tasarımcıları neden son bir yöntem içermiyordu? Düşünebilmemin tek nedeni: koleksiyon …
19 java  api-design 

2
REST API Tasarımı: Çoklu çağrılar ve API'ya yapılan tek çağrı
Mobil uygulamalar tarafından tüketilecek bir e-Ticaret web sitesi için bir Rest API geliştiriyoruz. Bir uygulamanın ana sayfasında Kaydırıcılar, En İyi Markalar, En Çok Satan Ürünler, Trend Olan Ürünler vb. API çağrıları yapmak için iki seçenek: Tek Çağrı: www.example.com/api/GetAllInHome Birden Fazla Çağrı: www.example.com/api/GetSliders www.example.com/api/GetTopBrands www.example.com/api/GetBestSellingProducts www.example.com/api/GetTrendingProducts Dinlenme api tasarımı için en …
19 rest  api  api-design  url 

4
Veritabanı soyutlama - abartılı mı?
Çok sayıda veritabanı soyutlama katmanına maruz kaldıktan sonra, verilere erişmek için kendi farklı paradigmalarını icat eden her kütüphanenin amacının ne olduğunu merak etmeye başlıyorum. Yeni bir DAL seçmek, tekrar tekrar yeni bir dil öğrenmek gibi geliyor, genellikle tek yapmak istediğim, katmanı kafamda zaten yazdığım bir SQL sorgusu çıkarmaya ikna etmek …
18 database  sql  api-design  dsl 

4
Java String'in neden statik dize düzenleme yöntemleri yok?
Java tasarımcıları neden java.lang.Stringsınıfta dize düzenleme yöntemlerinin statik sürümlerini oluşturmadı ? Aşağıdaki yöntemler, bahsettiğim şeydir, ancak soru sınıftaki diğer statik olmayan yöntemlere de genişletilebilir. concat(String) substring(int, int) replace(char, char) toLowerCase() replace(CharSequence, CharSequence) toLowerCase(Locale) replaceAll(String, String) toString() replaceFirst(String, String) toUpperCase() split(String) toUpperCase(Locale) split(String, int) trim() substring(int) Bu yöntemlerin yalnızca statik olmayan …
17 java  api-design  null 

3
IEnumerable “Durum Makinelerini” Tespit Etme
Ben sadece c # verim dönüşü ile çok şirin Başlarken adlı ilginç bir makale okudum Bir IEnumerable'ın gerçek bir numaralandırılabilir koleksiyon olup olmadığını veya verim anahtar kelimesi ile oluşturulan bir durum makinesi olup olmadığını tespit etmenin en iyi yolunun ne olduğunu merak etmemi sağladı. Örneğin, DoubleXValue'yu (makaleden) aşağıdaki gibi değiştirebilirsiniz: …
17 c#  api-design 

3
Bir arayüzde string_view'i ne zaman kullanmalıyım?
Ben mimik a amacıyla tasarlanmış, bir iç kitaplığı kullanıyorum C ++ kütüphanesi önerdi ve bazen son birkaç yıl içinde gördüğüm kendi arayüzü kullanarak değiştirildi std::stringkadar string_view. Bu yüzden yeni arayüze uymak için kodumu saygıyla değiştiriyorum. Ne yazık ki, ne geçmek zorunda bir std :: string parametresi ve std :: string …

2
RESTful API'sında iç içe kaynaklar ne zaman kullanılır?
İki kaynağım var: kullanıcılar ve bağlantılar. Kullanıcıların kendileriyle ilişkili birkaç bağlantısı olabilir. Aşağıdaki URI'da bir kullanıcıyla ilişkili bağlantılara erişebilmeniz için RESTful API'mi tasarladım: /users/:id/links Ancak, her zaman sadece bağlantılar için bir URI'ye ihtiyacım var - bazen kullanıcı ne olursa olsun tüm bağlantıları isteyebilirim. Bunun için var: /links Kulağa hoş geliyor …
16 api  rest  api-design 

3
REST API'lerini sürümleme. Her API'nın kendi sürümü vardır
URL'de REST API'lerinin sürümünü, özellikle yolun başlangıcında, yani aşağıdaki gibi bir şey belirtmek çok yaygındır: POST /api/v1/accounts GET /api/v1/accounts/details Ancak, sürümün her API ile ilişkili olduğu herhangi bir tasarım görmedim. Başka bir deyişle, her bir API'nın sürümünü ayrı tutuyoruz. yani: POST /api/accounts/v2 GET /api/accounts/details/v3 Bu yaklaşımı kullanarak, değişikliği bozulduğunda belirli …

1
RESTful API ve i18n: Yanıt nasıl tasarlanır?
Esas olarak tek bir müşterinin ihtiyaçlarını karşılamaya yönelik RESTful API tasarlıyoruz. Çok özel koşulları nedeniyle, bu müşteri mümkün olduğunca az istekte bulunmalıdır. API, i18n'yi isteklerde bir Accept-Language üstbilgisi aracılığıyla işler. Bu, istemcinin bir isteğin yanıtlarını kullanılabilir tüm yerel ayarlarda depolaması gereken bir özellik dışında istemcinin yapması gereken her şey için …
15 rest  api  api-design  http 

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.