Skip to content
Back to changelog

API V3 als Preview verfügbar — V2 soll zum Jahresende abgeschaltet werden

Die V3-API ist ab sofort als Preview-Release verfügbar — die nächste Generation der Librario-API. V3 räumt Altlasten der V2 auf und bringt unter anderem:

  • typisierte identifiers-Liste (statt der flachen doi/isbn/pmid/arxiv_id/issn-Felder)
  • eigene Endpoints für verschachtelte Ressourcen (Autor:innen, Herausgeber:innen, Kategorien, Identifikatoren) mit Replace-Semantik
  • dedizierte DELETE /…/:id-Endpunkte statt _destroy-Markern
  • vereinheitlichtes PATCH /users/:id (statt drei verschiedener User-Update-Endpunkte)
  • das veraltete import_state-Feld auf Publikationen ist entfernt

Migrations-Hinweis: V3 ist als Preview gekennzeichnet — die Schnittstelle kann sich bis zur stabilen Freigabe noch ändern. Für den Produktivbetrieb empfehlen wir, die Migration jetzt zu planen und erst nach dem stabilen V3-Release umzusetzen.

V2 soll zum Jahresende 2026 abgeschaltet werden. Bis dahin bleibt V2 unverändert verfügbar; einzelne Felder (import_state, flache Identifikator-Parameter, zwei User-Endpunkte) sind bereits jetzt mit X-API-Deprecation-Headern markiert. Wer V2 produktiv nutzt, sollte die Umstellung auf V3 in den nächsten Monaten einplanen.

Die vollständige V3-Schnittstelle finden Sie in der Integration-API-Dokumentation.