Als «api-design» getaggte Fragen

301
Was sind Best Practices für verschachtelte REST-Ressourcen?

Soweit ich das beurteilen kann, sollte jede einzelne Ressource nur einen kanonischen Pfad haben. Was wären im folgenden Beispiel gute URL-Muster? Nehmen Sie als Beispiel eine Restrepräsentation von Unternehmen. In diesem hypothetischen Beispiel kann jedes Unternehmen besitzt 0 oder mehr...

288
Best Practices für die API-Paginierung

Ich würde gerne Hilfe bei der Bearbeitung eines seltsamen Randfalls mit einer paginierten API erhalten, die ich erstelle. Wie viele APIs paginiert diese große Ergebnisse. Wenn Sie / foos abfragen, erhalten Sie 100 Ergebnisse (z. B. foo # 1-100) und einen Link zu / foos? Page = 2, der foo # 101-200...

239
Warum sind Java Streams einmalig?

Im Gegensatz zu C # IEnumerable, bei denen eine Ausführungspipeline so oft ausgeführt werden kann, wie wir möchten, kann ein Stream in Java nur einmal "iteriert" werden. Jeder Aufruf einer Terminaloperation schließt den Stream und macht ihn unbrauchbar. Diese 'Funktion' nimmt viel Energie weg. Ich...

91
GB Englisch oder US Englisch?

Wenn Sie über eine API verfügen und ein in Großbritannien ansässiger Entwickler mit einem sehr internationalen Publikum sind, sollte dies Ihre API sein setColour() oder setColor() (Um ein Wort als einfaches Beispiel zu nehmen.) In Großbritannien ansässige Ingenieure sind in Bezug auf ihre...

83
Token abgelaufen - JSON REST API - Fehlercode

Ich habe eine JSON-REST-API. Es gibt einen Handschlag, mit dem Sie einen Token erhalten, der 15 Minuten gültig ist. Alle Anrufe, die Sie innerhalb dieser 15 Minuten tätigen, sollten in Ordnung sein. Nach den 15 Minuten gebe ich ein Fehlerobjekt zurück (einschließlich Code, Nachricht, Erfolg =...