====== OSN API v3 ====== Hier sammle ich Punkte, die ich für Version 3 der OSN API vor habe. ===== RESTful ===== ^Methode^URI^Bedeutung^Parameter^ |GET|/v3/status|Listet alle Status-Einträge|Paginierung und Sortierungs-Parameter| |GET|/v3/status/{statusId}|Gibt Status mit {statusId} aus| | |POST|/v3/status|Erstellt neuen Status-Eintrag (löst /cmd/open & /cmd/close ab)| | |PUT|/v3/status/{statusId}|Aktualisiert Status (geht nur wenn der Status aktuell ist; löst /cmd/message ab), z.B. Nachrichtanpassung. Hier muss das komplette Objekt übergeben werden| |PATCH|/v3/status/{statusId}|Aktualisiert Status. Hier müssen nur geänderte Felder übergeben werden| ===== Authentifizierung ===== TODO ===== Dokumentation ===== Mit [[http://editor.swagger.io/|Swagger Editor]] Dokumentation und Clients erstellen