«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.

14
Arka ucunuzu bir API olarak mı yazmalısınız?
Bugün MVC uygulamamızla ilgili ateşli bir tartışma yaptım. MVC'de ( ASP.NET ) yazılmış bir web sitemiz var ve genellikle görünümde bir şeyler yapmanın modelini izliyor -> denetleyiciye isabet et -> denetleyici bir model oluşturur (veri alan bir Yöneticisi çağırır, modeli oluşturur. denetleyici yönteminin kendisi) -> model görüntülemeye gider -> durulama …

4
Yolsuzlukla Mücadele katmanı nedir ve nasıl kullanılır?
Yolsuzlukla Mücadele katmanının gerçekte ne anlama geldiğini bulmaya çalışıyorum. Eski kodlar veya hatalı API'ler arasında geçiş yapmanın / çalışmanın bir yolu olduğunu biliyorum. Anlamadığım şey, nasıl çalıştığı ve istenmeyen katmandan temiz bir ayrılık kılan şey. Bazı araştırmalar yaptım, ancak basit örnekler veya açıklamalar bulamıyorum, bu yüzden onu anlayan ve basit …

7
Aramalar RESTful bir arayüze nasıl uyar?
RESTful bir arayüz tasarlarken, talep tiplerinin anlamları tasarım için hayati önem taşır. GET - Koleksiyon listesi veya alma elemanı PUT - Koleksiyon veya öğeyi değiştir POST - Koleksiyon veya öğe oluştur DELETE - Eh, erm, koleksiyon veya öğeyi sil Ancak, bu "arama" kavramını kapsamıyor gibi görünmüyor. Örneğin, bir İş Arama …

14
Çözüm mümkün olduğunca jenerik mi yoksa mümkün olduğunca spesifik mi olmalı?
Diyelim ki "type" özelliğine sahip bir varlık var. 20+ olası tip olabilir. Şimdi, tek kullanım durumu olan A-> B türünü değiştirmeye izin verecek bir şey yapmam isteniyor. Öyleyse, geçerli türler olduğu sürece türün keyfi değişikliklerine izin veren bir şey mi uygulamalıyım? Yoksa SADECE gereksinime göre A-> B'den değişmesine izin vermeli …

5
Bir parametre sözdizimsel olarak doğruysa, ancak bir iş kuralını ihlal ederse, bir HTTP 400 (Kötü İstek) durumu döndürmeli miyim?
Parametre olarak bir tamsayı alan bir REST bitiş noktasına sahip olduğumu söyleyin: /makeWaffles?numberOfWaffles=3 Bu durumda, sayının pozitif olmasını istiyorum çünkü negatif sayıda gözleme yapamıyorum (ve 0 gözleme istemek zaman kaybıdır). Bu yüzden pozitif bir tamsayı içermeyen herhangi bir isteği reddetmek istiyorum. Ayrıca bazı maksimum tamsayıları aşan bir isteği reddetmek istiyorum …
56 api-design  http 

9
Harici API'lerden beklenmeyen değerlere karşı korunmalı mıyım?
Diyelim ki harici bir API'den girdi alan bir işlevi kodluyorsunuz MyAPI. Bu harici API'nin MyAPI, a stringveya a döndüreceğini belirten bir sözleşmesi vardır number. O gibi şeyler karşı korumak için önerilen mı null, undefined, booleanbunun API parçası olmadığı halde, vb MyAPI? Özellikle, bu API üzerinde kontrol sahibi olmadığınız için, statik …



6
Çok sayıda küçük istek ve çok sayıda büyük istek (API Tasarımı)
Şu anda bir kuruluşla birlikte bir proje üzerinde çalışıyorum: İstemci - Ana sunucudan veri REST api ile alır. Sunucu - Üçüncü taraf API'ler aracılığıyla diğer çeşitli sunuculardan veri ister Üçüncü taraf API'leri - Sunucuya veri sağlayan denetimim dışındaki hizmetler (Reddit, Hackernews, Quora, vb.) Argüman uğruna, müşterinin önce üçüncü taraf API'lerinin …

3
Neden PATCH yöntemi belirsiz değil?
Bunu merak ediyordum. Diyelim ki ve userile bir kaynak var . Bir alanı güncellemek istersem, bunun gibi bir kaynağa PATCH isteği yapabilirimidname PATCH /users/42 {"name": "john doe"} Ve sonra uygulama kullanıcı 42 adını güncelleyecektir. Peki neden bu talebi tekrarlarsam sonuç farklı olur? RFC 5789’a göre PATCH ne güvenli ne de …

6
Asla kamuya açıklanmayacak kod için savunma programlama uygulamalarını takip etmek ne kadar gerekli?
Bir kart oyununun Java uygulamasını yazıyorum, bu yüzden bir Bölge dediğim özel bir Koleksiyon türü oluşturdum. Java'nın Koleksiyonundaki tüm modifikasyon yöntemleri desteklenmemektedir, ancak Zone API'de move(Zone, Card)bir Kartı belirli bir Bölgeden kendisine taşıyan (özel paket teknikleriyle gerçekleştirilen) bir yöntem vardır. Bu şekilde, hiçbir bölgeden kart çıkartılmadığından emin olabilirim; sadece başka …

3
DOM ile ilgili bu kadar kötü olan ne?
DOM'nin korkunç bir API olduğunu söyleyen insanları (özellikle Crockford) duymaya devam ediyorum, ancak bu ifadeyi gerçekten haklı göstermiyor. Çapraz tarayıcı tutarsızlıklarının yanı sıra, DOM’in bu kadar kötü kabul edilmesinin nedenleri nelerdir?

8
Java.util.ArrayList null eklemeye izin veriyor?
Neden java.util.ArrayListeklememe izin verdiğimi merak ediyorum null. Ben eklemek istiyorum herhangi bir vaka var mı nullbir etmek ArrayList? Bir projede bazı kod ekleyerek olan bir hatayı vardı çünkü bu soruyu soruyorum nulliçin ArrayListve hata nerede nokta zordu. Açıkçası bir NullPointerExceptionatılmış, ancak diğer kodlar öğeye erişmeye çalışmadıkça atılmıştı. Sorun, nullnesneyi ekleyen …

1
null vs REST API Yanıtında eksik anahtar [kapalı]
Diyelim ki uygulamamda, bazı kullanıcılar bize soyadlarını veriyor, bazıları ise kullanmıyor. Bir REST API yanıtında, hangi gövde tercih edilir: "Boş" bir değerle: {"firstName": "Bob", "lastName": null} Ya da sadece eksik bir anahtar: {"firstName": "Bob"}
40 rest  api-design  json 

11
Bir REST API, bir sorgunun var olmayan bir nesneye başvurduğunu belirtmek için 500 Dahili Sunucu Hatası döndürmeli midir?
Çok sayıda IoT aygıtının verilerini işleyen bir sunucuda bulunan bir REST API ile çalışıyorum. Görevim, söz konusu cihazlar hakkında belirli performans bilgilerini toplamak için API'yi kullanarak sunucuyu sorgulamak. Bir örnekte, kullanılabilir cihazların ve bunlara karşılık gelen tanımlayıcıların bir listesini edindim, daha sonra bu tanımlayıcıları (GUID'ler) kullanarak daha fazla ayrıntı için …

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.