Beispiel für einen guten Webservice

Question

Ich habe den Auftrag, eine neue API für unsere Infrastruktur zu entwickeln. Einige der Dinge, Ich mag würde zu tun ist:

• implementieren oauth zur Authentifizierung
• gute XML-basierten Struktur, die Anpassung ATOM, GEO-RSS und andere XML-Schema-Standards, soweit anwendbar.
• JSON Ausgabe

Einige der Dinge, die ich habe gedacht worden, um REST bewirbt. In der Praxis finde ich, dass es nicht so einfach zu verstehen ist wie ein "Methode, Argument, Ergebnis" -RPC-Modell.

Gerade weil es kein einfaches CRUD-Modell gibt, sondern etwa 250 verschiedene Operationen macht es für mich wenig Sinn.

Ich frage mich, wie ich eine gute Zuordnung zwischen JSON-Format und Namespace-XML-Format erstellen soll. Wenn dies nicht intuitiv funktioniert, werde ich alle Datentypen manuell zuordnen.

Also im Grunde frage ich mich, was Sie denken, und wenn Sie Beispiele für APIs haben, die komplex, aber einfach zu bedienen waren.

Falls Sie sich wundern, SOAP ist nicht in Frage.

Answer 1

Die britische Zeitung die Guardian hat eine ausgezeichnete (neue) API. Es ist groß, hat eine Reihe von Client-Bibliotheken und verfügt über eine sehr gute API explorer - die als ein geteilter Bereich in Ihrem Browser mit einer Live-Konsole für das Spielen mit der API fungiert.