Pytania oznaczone «api-design»

Interfejs programowania aplikacji (API) omawia najlepsze praktyki tworzenia bibliotek przeznaczonych do ogólnego użytku lub użytku publicznego.

322
Czy powinieneś napisać swój back-end jako API?

Dzisiaj miałem gorącą dyskusję na temat naszej aplikacji MVC. Mamy stronę internetową napisaną w MVC ( ASP.NET ) i zwykle jest zgodna ze schematem robienia czegoś w widoku -> uderz w kontroler -> kontroler buduje model (wywołuje menedżera, który pobiera dane, buduje model w sama metoda...

48
Dlaczego metoda PATCH nie jest idempotentna?

Zastanawiałem się nad tym. Załóżmy, że mam userzasób idi namepolami. Jeśli chcę zaktualizować pole, mogę po prostu wysłać PATCH do takiego zasobu PATCH /users/42 {"name": "john doe"} A następnie aplikacja zaktualizuje nazwę użytkownika 42. Ale dlaczego, jeśli powtórzę tę prośbę, wynik byłby...

42
Co jest tak złego w DOM?

Ciągle słyszę ludzi (w szczególności Crockford), którzy mówią, że DOM to straszne API, ale tak naprawdę nie uzasadniają tego stwierdzenia. Oprócz niespójności między przeglądarkami, jakie są niektóre powody, dla których DOM jest tak źle

39
Czy interfejs API REST powinien zwrócić błąd wewnętrzny serwera 500, aby wskazać, że zapytanie odwołuje się do obiektu, który nie istnieje?

Pracuję z interfejsem API REST, który znajduje się na serwerze, który obsługuje dane dla wielu urządzeń IoT. Moim zadaniem jest wysłanie zapytania do serwera za pomocą interfejsu API w celu zebrania określonych informacji o wydajności tych urządzeń. W jednym przypadku uzyskuję listę dostępnych...

38
Czy istnieje wzorzec obsługi sprzecznych parametrów funkcji?

Mamy funkcję API, która dzieli całkowitą kwotę na kwoty miesięczne na podstawie danych dat rozpoczęcia i zakończenia. // JavaScript function convertToMonths(timePeriod) { // ... returns the given time period converted to months } function getPaymentBreakdown(total, startDate, endDate) { const...

33
Czy interfejs API HTTP powinien zawsze zwracać treść?

Czy istnieje jakiś standard dotyczący odpowiedzi API HTTP? Po przeczytaniu tego wątku dyskursu zacząłem się zastanawiać. W mojej pracy opracowujemy nasz publiczny interfejs HTTP JSON API i nie zwracamy niczego, gdy nie jest to absolutnie potrzebne (na przykład PUT do / resource / {id} zwraca tylko...