Pytania oznaczone «api-design»

17
Wykrywanie niezliczonych „automatów stanowych”

Właśnie przeczytałem interesujący artykuł zatytułowany Robi się zbyt słodki z zyskiem c # Zastanawiałem się, jaki jest najlepszy sposób na wykrycie, czy IEnumerable jest faktyczną kolekcją, którą można wyliczyć, czy też jest maszyną stanu wygenerowaną za pomocą słowa kluczowego fed. Na przykład...

16
Kiedy powinienem używać string_view w interfejsie?

Korzystam z biblioteki wewnętrznej, która została zaprojektowana tak, aby naśladować proponowaną bibliotekę C ++ , a czasami w ciągu ostatnich kilku lat widzę, że jej interfejs zmienił się z używania std::stringna string_view. Dlatego sumiennie zmieniam kod, aby dostosować się do nowego...

15
RESTful API i i18n: jak zaprojektować odpowiedź?

Projektujemy interfejs API RESTful przeznaczony głównie do zaspokojenia potrzeb jednego klienta. Ze względu na bardzo szczególne okoliczności ten klient musi składać jak najmniej zapytań. Interfejs API obsługuje i18n za pomocą nagłówka Accept-Language w żądaniach. Działa to dla wszystkich rzeczy,...

13
Użyj kompozycji i dziedziczenia dla DTO

Mamy interfejs API sieci Web ASP.NET, który zapewnia interfejs API REST dla naszej aplikacji jednostronicowej. Używamy DTO / POCO do przesyłania danych przez ten interfejs API. Problem polega na tym, że z czasem te DTO stają się coraz większe, więc teraz chcemy zmienić DTO. Szukam „najlepszych...

13
Kiedy powinienem używać AtomPub?

Prowadzę badania nad projektowaniem usług internetowych RESTful i doszedłem do tego, co uważam za kluczowy punkt decyzji, więc pomyślałem, że zaoferuję to społeczności, aby uzyskać porady. Zgodnie z zasadami architektury RESTful chcę zaprezentować wykrywalny interfejs API, dlatego będę wspierał...

12
Czy powinienem zezwolić na nieznane parametry?

Projektuję interfejs API RESTful i napotkałem problem z tytułem, dla zachowania przejrzystości: Czy powinienem szybko zawieść, jeśli klient wyśle ​​nierozpoznany parametr? Na przykład, http://example.com/api/foo?bar=true&paula=bean Powyżej barjest poprawnym parametrem, ale paulanie jest...

12
Usługa API MVC i RESTful

MVC jest dość proste. Istnieje model, kontroler i widok. Kiedy tworzymy stronę internetową, wszystko się łączy, gdy „ klient wysyła żądanie słowa kluczowego REST do serwera -> serwer dopasowuje żądany adres URL do działania kontrolera -> który następnie wywołuje model (y) do gromadzenia /...

12
Zachowaj API zamiast używania idiomów w porcie

Pracuję na porcie od Pythona do Rusta i natrafiłem na kod, który nie może być wyrażony w Rust tak naturalnie, jak w Pythonie. Jednym z takich przypadków jest użycie parametrów domyślnych: class Foo: def __init__(self, a="Hello"): self._a = a W Rust możesz to zaimplementować za pomocą...

12
Projektowanie interfejsu API biblioteki C ++

Szukam dobrego zasobu do nauki o dobrym projektowaniu API dla bibliotek C ++, przeglądaniu współdzielonych obiektów / bibliotek dll itp. Istnieje wiele zasobów na temat pisania fajnych API, ładnych klas, szablonów itp. Na poziomie źródła, ale prawie nic o łączenie rzeczy we wspólnych bibliotekach i...