APIv2
Das Coscine-Entwicklungsteam hat fleißig an einer neuen API-Version (APIv2) gearbeitet, damit die Features in Coscine weiterhin verbessert werden können. Die neue API-Version ist seit einer Woche live und es werden noch einige kleine Änderungen vorgenommen.
Hinweis
Bitte beachten: Bei bestehenden Anbindungen an die API, die APIv1 nutzen wie z.B. unter anderem auch bei der Python SDK, kann es zu Problemen kommen.
APIv2 Dokumentation
Die neue API wurde mittels Swagger dokumentiert. Auf der eigens dafür eingerichteten API Dokumentationsseite finden Sie Informationen zu den API Endpunkten und können die API direkt live mittels eines API-Tokens austesten.
Entwicklung und Feedback
Wir sind über jedes Feedback unserer Nutzerschaft dankbar und haben in GitLab für jeden Endpoint der API ein entsprechendes Issue angelegt. Dort kann Feedback hinterlassen werden, was bei den entsprechenden Endpoints funktioniert und wo möglicherweise Fehler (Bugs) auftreten.
Um zu den Issues zu gelangen einfach auf den Namen des entsprechenden Endpoints klicken.
Hier noch ein paar kleine Hinweise, wie die Diskussionen innerhalb des Issues ablaufen können:
- Falls Sie sich an einer Diskussion beteiligen wollen oder ein Feature von einem Controller nutzen wollen, können Sie das entsprechende Issue abonnieren.
- Sobald die Entwickler an Implementierungen arbeiten, wird dies im Issue kommuniziert.
- Die Abonennten werden automatisch benachrichtigt in Form einer Info und können sich dadurch auf Änderungen vorbereiten. -Sobald alle Diskussionen im Issue geklärt sind, wird dieses geschlossen. Das bedeutet auch, dass der Controller demnach als "stabil" eingestuft wird.
- Treten neue Diskussionspunkte bei einem geschlossenen Issue auf, kann dieses kommentiert und dazu bitte @coscine-collaboration getaggt werden. Dadurch wird sichergestellt, dass jemand aus dem Entwicklungsteam die Anfrage schnellstmöglich sieht und bearbeiten kann.
Vielen Dank für die Mithilfe!