Pytania otagowane jako api-design

Projektowanie interfejsu API to proces określania i ujawniania zestawu spójnych sygnatur metod, wartości zwracanych i dokumentacji przeznaczonych do użytku przez innych programistów w celu umożliwienia programistycznego dostępu do danych.

7
Jakie są najlepsze praktyki dotyczące zagnieżdżonych zasobów REST?
O ile mogę stwierdzić, każdy pojedynczy zasób powinien mieć tylko jedną ścieżkę kanoniczną . Więc w poniższym przykładzie, jakie byłyby dobre wzorce adresów URL? Weźmy na przykład reprezentację firm. W tym hipotetycznym przykładzie każda firma posiada 0 lub więcej działów, a każdy dział posiada 0 lub więcej pracowników. Dział nie …
301 rest  api-design 
11
Najlepsze praktyki podziału na strony w interfejsie API
Chciałbym trochę pomóc w rozwiązaniu dziwnego przypadku przy tworzeniu stronicowanego API. Podobnie jak wiele interfejsów API, ten paginuje duże wyniki. Jeśli zapytasz / foos, otrzymasz 100 wyników (tj. Foo # 1-100) i link do strony / foos? = 2, które powinny zwrócić foo # 101-200. Niestety, jeśli foo # 10 …
5
Dlaczego strumienie Java są jednorazowe?
W przeciwieństwie do C # IEnumerable, gdzie potok wykonania może być wykonywany tyle razy, ile chcemy, w Javie strumień można „iterować” tylko raz. Każde wywołanie operacji terminalowej zamyka strumień, co czyni go bezużytecznym. Ta „funkcja” zabiera dużo energii. Wyobrażam sobie, że powód tego nie jest techniczny. Jakie były uwagi projektowe …
7
Kiedy używać parametrów ścieżki, a kiedy parametrów zapytań w RESTful API?
Chcę, aby mój interfejs API RESTful był bardzo przewidywalny. Jaka jest najlepsza praktyka przy podejmowaniu decyzji, kiedy dokonać segmentacji danych przy użyciu identyfikatora URI, a nie przy użyciu parametrów zapytania. Wydaje mi się sensowne, że parametry systemowe obsługujące paginację, sortowanie i grupowanie znajdują się po znaku „?” A co z …
4
Dlaczego String.valueOf (null) zgłasza wyjątek NullPointerException?
zgodnie z dokumentacją metoda String.valueOf(Object obj)zwraca: jeśli argumentem jest null, to łańcuch równy "null"; w przeciwnym razie zwracana obj.toString()jest wartość . Ale jak to się dzieje, kiedy próbuję to zrobić: System.out.println("String.valueOf(null) = " + String.valueOf(null)); zamiast tego rzuca NPE? (spróbuj sam, jeśli nie wierzysz!) Wyjątek w wątku „main” java.lang.NullPointerException w …
28
GB English czy US English?
Jeśli masz interfejs API i jesteś programistą z siedzibą w Wielkiej Brytanii z wysoce międzynarodową publicznością, jeśli masz API setColour() lub setColor() (Aby wziąć jedno słowo jako prosty przykład.) Inżynierowie z Wielkiej Brytanii często dość defensywnie podchodzą do „prawidłowej” pisowni, ale można argumentować, że pisownia amerykańska jest bardziej „standardowa” na …
3
Token wygasł - JSON REST API - Kod błędu
Mam JSON REST API. Po uścisku dłoni otrzymasz token ważny przez 15 minut. Wszystkie połączenia, które wykonasz w ciągu tych 15 minut, powinny działać poprawnie. Po 15 minutach zwracam obiekt błędu (zawiera kod, wiadomość, sukces = fałsz), ale zastanawiałem się również, jaki kod błędu HTTP powinienem zwrócić? I czy używanie …
Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.