---
type: Changelog Entry
title: API V3 als Preview verfügbar — V2 soll zum Jahresende abgeschaltet werden
resource: https://www.librario.de/de/changelog/2026-03-api-v3-preview
tags:
- 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](/de/docs/integration/api).