«api-design» etiketlenmiş sorular

Kapalı . Bu sorunun daha fazla odaklanması gerekiyor . Şu anda cevapları kabul etmiyor. 6 yıl önce kapalı . Kilitli . Bu soru ve cevapları kilitlidir çünkü soru konu dışıdır, ancak tarihsel önemi vardır. Şu anda yeni yanıtları veya etkileşimleri kabul etmiyor. Harika API'lerle ilgili onları harika yapan nedir? Ben …

15 api-design 

Birçok kullanıcıyı destekleyecek bir uygulama geliştiriyorum. Mesele şu ki, istemci / kullanıcının kimliğini nasıl doğrulayacağım. Kullanıcılarıma kimlik bilgileri vereceğim http://quickblox.com/ gibi bir uygulama oluşturuyorum ve bunları kimlik doğrulaması için kullanıcı adlarını ve şifrelerini koyamayacakları N uygulamaları oluşturmak için kullanacaklar . Diyelim ki aşağıdaki gibi gider. (Tıpkı QuickBlox gibi) 1. Kullanıcı …

14 design-patterns  architecture  api-design  authentication  enterprise-architecture 

Hizmet bir REST API tasarlıyorum ve kaynakları yuvalamak için uygun bir şekilde takılıp var. Kaynaklar: ortaklar, biletler, ayarlar Kaynaklar arasındaki bağlantılar: eşin birçok bileti var, iş ortağı ayarlara sahip, İş mantığı: tüm ortakları anonim kullanıcı olarak listeleyebilirsiniz, anonim kullanıcı olarak belirtilen iş ortağına yeni bilet ekleyebilirsiniz, sadece iş ortağı biletlerini …

14 api  rest  api-design 

Bir JavaScript kütüphanesi tasarlıyor Magician.js. Linchpin, Rabbitgeçirilen argümanın dışına çıkan bir işlevdir . Kullanıcılarının bir tavşanı a String, a Number, a Function, belki de a'dan çıkarmak isteyebileceğini biliyor HTMLElement. Bunu akılda tutarak, API'sını şöyle tasarlayabilir: Sıkı arayüz Magician.pullRabbitOutOfString = function(str) //... Magician.pullRabbitOutOfHTMLElement = function(htmlEl) //... Yukarıdaki örnekteki her işlev, işlev …

14 javascript  api  api-design 

Bu adamın söylediklerine dayanarak: http://toddfredrich.com/ids-in-rest-api.html API kaynaklarını tanımlamak için UUID kullanma konusunda haklı olduğunu varsayalım. Sonra bu şekilde uygulamaya çalışırken sorunlarla karşılaşıyorum, bu: class FooEntity { final String id = null; //auto-generated by my backend (mongodb), not shared final UUID uid = UUID.randomUUID(); //the resource id } (İstemci ve sunucu …

14 database  api-design  mongodb 

Tek Sayfa Uygulamamız için bir REST API'si sağlayan bir ASP.NET Web API'miz var. Bu API üzerinden veri aktarmak için DTO'lar / POCO'lar kullanıyoruz. Sorun şu ki, bu DTO'lar zamanla büyüyor, bu yüzden şimdi DTO'ları yeniden düzenlemek istiyoruz. Ben nasıl bir DTO tasarlamak için "en iyi uygulamalar" arıyorum: Şu anda sadece …

13 rest  api-design  web-api  dto  poco 

RESTful web hizmeti tasarımı üzerine bazı araştırmalar yapıyorum ve önemli bir karar noktası olduğunu düşündüğüm şeylere ulaştım, bu yüzden biraz tavsiye almak için topluma sunacağımı düşündüm. RESTful mimarisinin ilkelerine uygun olarak keşfedilebilir bir API sunmak istiyorum, bu yüzden çeşitli HTTP fiillerini mümkün olduğunca eksiksiz destekleyeceğim. Zorluğum bu kaynakların temsili seçimi …

13 web-services  rest  api-design 

Bağımlılık Enjeksiyon Prensipleri, Uygulamaları ve Desenler kitabını okuyorum ve kitapta iyi tarif edilen sızdıran soyutlama kavramını okudum. Bu gün bağımlılık enjeksiyon kullanarak bir C # kod tabanı refactoring böylece engelleme yerine async çağrıları kullanılır. Bunu yaparken kod tabanımdaki soyutlamaları temsil eden ve zaman uyumsuz çağrıların kullanılabilmesi için yeniden tasarlanması gereken …

13 c#  object-oriented  api-design  interfaces  dependency-injection 

Zaten ~ 5 kez ileri geri döndüm. Bu REST bitiş noktası /api/tags/dahili kullanım için olacak (3. taraf istemciler yok), onunla çalışan tek kişi benim. Bu iki temsil arasında karar veriyorum: Düz { "types":[ { "id":1, "text":"Utility" }, { "id":7, "text":"Lease Terms" }, ], "tags":[ { "id":8, "text":"Water", "type":1 }, { …

12 rest  api-design  json 

RESTful API tasarlıyorum ve başlık sorunu ile karşı karşıya, netlik için yeniden ifade: İstemci tanınmayan bir parametre gönderirse hızlı bir şekilde başarısız olmam gerekir mi? Örneğin, http://example.com/api/foo?bar=true&paula=bean Yukarıda, bargeçerli bir parametredir ancak paulaAPI tarafından belirtilmemiştir. Yapmalımıyım İstemciyi hatayı uyar Hızlı başarısız Boşver İstemciyi uyarırsam, yalnızca ilk parametre için bir uyarı …

12 rest  api-design 

Python Rust için bir bağlantı noktası üzerinde çalışıyorum ve doğal olarak Python gibi Rust olarak ifade edilemez bazı kod koştu. Bunun bir örneği varsayılan parametreleri kullanmaktır: class Foo: def __init__(self, a="Hello"): self._a = a Rust'ta bunu bir oluşturucu kullanarak uygulayabilirsiniz: struct FooBuilder { a: &'static str, } struct Foo { …

12 api-design  porting 

Umarım olabildiğince RESTful hale getirmek için bir HTTP API tasarlama sürecindeyim. İşlevselliğin birkaç kaynağa yayıldığı bazı eylemler vardır ve bazen geri alınması gerekir. Kendi kendime düşündüm, bu bir komut kalıbına benziyor, ama onu bir kaynağa nasıl modelleyebilirim? Böyle bir şeyle yaratılacak olan DepositAction gibi XXAction adında yeni bir kaynak tanıtacağım …

12 design-patterns  api  rest  api-design  http 

C ++ kütüphaneleri için iyi API tasarımı hakkında bilgi edinmek, paylaşılan nesneleri / dll'leri vb. İncelemek için iyi bir kaynak arıyorum. Güzel API'ler, güzel sınıflar, şablonlar ve benzeri kaynak seviyesinde yazma konusunda birçok kaynak var, ancak neredeyse hiçbir şey yok şeyleri paylaşılan kütüphanelerde ve yürütülebilir dosyalarda bir araya getirmek. John …

12 c++  libraries  api-design  dll 

Örneğin varlıklarım var: Müşteri, Rapor. Müşteri birçok Rapor içerebilir ve tek bir Rapor yönetimi için uç nokta bu şekilde iç içe olması gerektiğini düşünüyorum: /clients/{client_id}/reports/{report_id} Bir müşterinin tüm raporlarına gelince, enpoint bekleniyor: /clients/{client_id}/reports Ancak, API'nın tutarlı ve iyi tasarlanmış olmasını sağlamak için tüm İstemcilerin Tüm Raporlarını almak için nasıl bir …

12 rest  api  api-design 

Tire (kebab-case) kullanan JSON anahtarlarına erişme etrafında dönen birçok soru görüyorum, ancak şimdi kendimi sadece anahtarlarımda camelCase veya snake_case'e yapışmam gerektiğini merak ediyorum. Tirelerin, diller arasında taşındığında karmaşık eşlemeler oluşturabileceğini de biliyorum. Bazı JSON serisini kaldırmak kütüphaneler bu anahtarları bir camelCase tarzı dönüştürmek gördüm. Misal: var something = { "some-value": …

12 javascript  api  api-design  json  web-api