Die beste Alternative zu Apiary

Apiary wird eingestellt. Oracle hat eine Ankündigung zur Beendigung des Apiary-Supports veröffentlicht, und Berichte aus dem API-Tooling-Bereich gehen davon aus, dass der endgültige Betrieb des gehosteten Dienstes um September 2026 eingestellt wird. Die Seite lädt heute immer noch, aber die Entwicklung ist seit Jahren absehbar: Oracle hat Apiary im Januar 2017 übernommen, die kostenpflichtigen Pläne 2018 eingestellt und die umliegenden Open-Source-Tools (Dredd, Gavel) in den Archivierungsstatus übergehen lassen. Wenn Ihre API-Dokumentation auf apiary.io liegt, bewerten Sie keine Alternativen mehr. Sie migrieren, und die Frist können Sie nicht verschieben.

Hier ist die direkte Antwort: Apidog ist die beste Apiary-Alternative, da es alles ersetzt, was Apiary getan hat (Design-First-Spezifikationsbearbeitung, gehostete interaktive Dokumentation, ein Mock-Server) und die Teile hinzufügt, die Apiary nie fertiggestellt hat: automatisches API-Testing, spezifikationsgesteuerte Validierung zur Ablösung des nun archivierten Dredd und CI-Integration. Es ist kostenlos für bis zu 4 Benutzer, mit kostenpflichtigen Plänen ab $9 pro Benutzer und Monat. Der einzige Haken ist, dass Apidog API Blueprint-Dateien nicht direkt importiert, sodass Blueprint-basierte Projekte beim Umstieg eine einmalige Konvertierung nach OpenAPI benötigen. Dieser Artikel behandelt, was mit Apiary passiert, den genauen Migrationspfad einschließlich dieses Konvertierungsschritts und welche Alternative passt, wenn Apidog nicht die richtige ist.

Was tatsächlich mit Apiary passiert

Apiary, 2011 gegründet, hat den Design-First-API-Workflow als Produkt praktisch erfunden. Es brachte der Welt API Blueprint, ein Markdown-basiertes API-Beschreibungformat aus der Zeit, bevor OpenAPI gewann, sowie das dreispaltige Dokumentationslayout, das Stripe berühmt machte und von allen anderen kopiert wurde. Es umfasste einen gehosteten Mock-Server, GitHub-Synchronisation und ein Paar beliebter Open-Source-Tools für Vertragstests, Dredd und Gavel.

Dann kaufte Oracle es im Januar 2017, und das Produkt geriet in eine lange Stille. Kostenpflichtige Tarife wurden 2018 eingestellt, wodurch Apiary als kostenloser Legacy-Dienst verblieb, während Oracle Unternehmenskunden auf seine API Platform Cloud verwies. Die Entwicklung neuer Funktionen wurde eingestellt. Dredd und Gavel wurden archiviert. Und jetzt das formale Ende: Oracles Ankündigung der Support-Beendigung, wobei der gehostete Dienst voraussichtlich um September 2026 eingestellt wird. Bump.sh, einer der Anbieter von Migrationsleitfäden, formulierte es in seinem Abschiedsbeitrag unmissverständlich: Exportieren Sie Ihre API-Beschreibungen vor der Abschaltung, denn danach gibt es nichts mehr zu exportieren.

Zwei praktische Konsequenzen ergeben sich daraus. Erstens muss alles, was nur in Apiary existiert (API-Beschreibungen, Dokumentationstexte, Teamkonfiguration), jetzt entfernt werden, solange die Export-Schaltflächen noch funktionieren. Zweitens, da API Blueprint kein gepflegtes Nachfolgetool hat, ist die Migration auch eine Formatmigration: Das sinnvolle Zielformat ist OpenAPI, egal auf welcher Plattform Sie landen.

Was Sie ersetzen

Es hilft, genau zu definieren, was Apiary für Ihr Team geleistet hat, denn der Ersatz muss jeden Teil abdecken:

• Ein Design-First-Spezifikationseditor. Sie haben API Blueprint (oder in späteren Projekten OpenAPI 3.0) im Browser geschrieben, und die Dokumente wurden live aktualisiert.
• Gehostete interaktive Dokumentation. Die dreispaltige Referenz mit Beispielanfragen, unter einer apiary.io-URL.
• Ein Mock-Server. Jedes Apiary-Projekt erhielt einen gehosteten Mock-Endpunkt, der die Beispiele aus Ihrer Spezifikation bereitstellte, sodass Konsumenten integrieren konnten, bevor das Backend existierte.
• GitHub-Synchronisierung. Die Spezifikationsdatei befand sich in Ihrem Repo und wurde bidirektional synchronisiert.
• Vertragstests über Dredd. Der Open-Source-Runner, der Ihre Spezifikation gegen eine reale Implementierung wiederholte und Abweichungen meldete. Er ist jetzt archiviert; wir haben das Ersatzproblem in wie Sie Ihre API ohne Dredd gegen ihre Spezifikation validieren behandelt.

Dieses Bündel (Design, Dokumente, Mock, Validierung) entspricht genau der Form einer modernen API-Entwicklungsplattform. Deshalb ist das beste Migrationsziel kein Dokumentations-Renderer, sondern eine Plattform mit derselben Form und aktiver Entwicklung dahinter.

Die Antwort: Apidog

Apidog ist eine API-Entwicklungsplattform, die von über 500.000 Entwicklern genutzt wird. Es deckt den gesamten Lebenszyklus ab, den Apiary 2011 skizziert und dann nicht weiterentwickelt hat: Design, Dokumentation, Mocking, Debugging und automatisches Testen, alles gesteuert von einer Spezifikation.

Speziell für jemanden, der von Apiary migriert:

1. Design-First ist der Standard-Workflow. Apidog verfügt sowohl über einen visuellen Spezifikationseditor als auch über einen Code-Editor für OpenAPI 3.x. Sie definieren Endpunkte, Schemas und Beispiele einmal; Dokumente, Mocks und Tests sind generierte Ansichten dieser Definition, dieselbe Philosophie, die Apiary vorangetrieben hat, mit einem gepflegten Produkt dahinter.
2. Die Dokumente sind gehostet, interaktiv und gehören Ihnen. Veröffentlichte Dokumentationen erhalten das moderne Referenzlayout mit einer funktionierenden „Try it“-Konsole, auf einer benutzerdefinierten Domain, mit Versionierung. Keine apiary.io-URL, die bei einer Abschaltung verloren geht.
3. Der Mock-Server ist intelligenter als der, den Sie verlassen. Apiarys Mock spielte Ihre geschriebenen Beispiele ab. Apidogs Smart Mock generiert realistische Antworten aus Ihren Schemas, sobald die Spezifikation existiert, ohne dass Beispiele erforderlich sind, und Sie können benutzerdefinierte Mock-Regeln hinzufügen, wo Determinismus wichtig ist.
4. Die Vertragsvalidierung ersetzt Dredd. Apidogs automatisierte Testszenarien führen reale Anfragen gegen Ihre Implementierung aus und validieren Antworten gegen die Schemas der Spezifikation, was Dredd erledigte, zuzüglich Assertions, datengesteuerter Fälle und CI-Läufe über die Apidog CLI. Dokumente werden auch neben einem MCP-Server veröffentlicht, sodass KI-Agenten Ihre Spezifikation direkt lesen können; Details finden Sie unter was ist der Apidog MCP Server.

Migration von Apiary, Schritt für Schritt

Die Migration hat einen zusätzlichen Schritt im Vergleich zu einem normalen Tool-Wechsel, und es ist besser, dies im Voraus zu sagen: Apidog importiert OpenAPI (Swagger 2.0, OpenAPI 3.0 und 3.1), Postman-Collections, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL und Google Discovery, gemäß der Apidog Import-Dokumentation. API Blueprint ist nicht auf dieser Liste, daher müssen Blueprint-basierte Projekte zuerst nach OpenAPI konvertiert werden. In der Praxis ist dies ein einmaliger Befehl, und es ist derselbe Schritt, den jedes andere ernsthafte Ziel erfordert, da niemand mehr Blueprint-Tools pflegt.

1. Jetzt alles aus Apiary exportieren

Laden Sie für jedes Projekt die API-Beschreibung aus dem Apiary-Editor herunter. Wenn das Projekt mit GitHub synchronisiert ist, ist Ihre Quelle der Wahrheit bereits im Repo; stellen Sie sicher, dass sie aktuell ist. Spätere Apiary-Projekte, die in OpenAPI 3.0 erstellt wurden, sind bereits im richtigen Format und können Schritt 2 überspringen. Tun Sie dies zuerst und vollständig, bevor Sie etwas anderes anfassen: Exporte sind der Schritt mit einer Frist.

2. API Blueprint nach OpenAPI konvertieren

Verwenden Sie einen der gepflegten Konverter:

• api-spec-converter (LucyBot), das API Blueprint direkt nach OpenAPI konvertiert
• apib2swagger, ein fokussierter Blueprint-zu-Swagger/OpenAPI-Konverter
• openapi-format danach, wenn Sie die Ausgabe normalisieren und auf OpenAPI 3.1 aktualisieren möchten

Überprüfen Sie dann das Ergebnis (mit einem Validator wie vacuum oder einem beliebigen OpenAPI-Linter in Ihrer Toolchain) und prüfen Sie manuell zwei bekannte Schwachstellen: Authentifizierungsschemata, die API Blueprint nie formal modelliert hat und Konverter daher nicht vollständig wiederherstellen können, sowie jeglicher Prosa, die in den Markdown-Abschnitten von Blueprint und nicht in Endpunktbeschreibungen vorhanden war. Planen Sie eine Stunde pro API ein, nicht eine Woche; das Format ist Markdown, nicht Magie.

3. In Apidog importieren

Projekteinstellungen, Manueller Import, wählen Sie Ihre OpenAPI-Datei aus (oder importieren Sie von einer URL). Endpunkte, Schemas und Beispiele werden strukturiert und gruppiert. Referenzdokumente sind sofort verfügbar, und der Smart Mock-Server ist für jeden importierten Endpunkt ohne weitere Einrichtung live, was die von Apiary bereitgestellte „Mock-URL für Konsumenten“-Funktion wiederherstellt.

4. Die Teile neu aufbauen, die Apiary ohnehin nicht konnte

Verweisen Sie eine benutzerdefinierte Domain auf Ihre veröffentlichten Dokumente, damit die nächste Plattformabschaltung (egal welche) Ihre Docs-URL niemals mit sich zieht. Erstellen Sie Ihre Dredd-Checks als Apidog-Testszenarien neu: echte Anfragen, Schemavalidierung gegen die Spezifikation, lokal oder in CI über die CLI ausführen. Wenn Ihr Team Konsumenten hatte, die sich auf die Apiary Mock-URL verlassen haben, senden Sie ihnen die neue Mock-Basis-URL in derselben E-Mail, die den Umzug der Dokumente ankündigt.

Ein Einzel-API-Projekt ist an einem Nachmittag migriert, einschließlich Konvertierung. Ein Portfolio von einem Dutzend Blueprint-APIs ist ein Sprint, der hauptsächlich aus der manuellen Überprüfung der Auth-Schemata besteht.

Apiary vs. Apidog auf einen Blick

Was der Ersatz eines kostenlosen Tools kostet

Apiarys Preis war seine beste verbleibende Funktion, daher ist der faire Vergleich für ein migrierendes Team die jährliche Rechnung am Zielort. Basierend auf Listenpreisen: Apidog kostenlos für 4 Benutzer, dann $9 pro Benutzer und Monat, SwaggerHub Team für $34,44 pro Benutzer und Monat, ReadMe Pro für $250 pro Monat (jährlich abgerechnet):

Der ehrliche Hinweis: Wenn Sie lediglich einen kostenlosen Ort zum Rendern einer Spezifikation benötigen, bieten auch mehrere reine Dokumentationstools kostenlose Tarife an, und die obige Tabelle ist erst relevant, wenn Sie den Mock-Server, das Testen und die Zusammenarbeit wünschen, die Apiary überhaupt erst nützlich gemacht haben. Apidogs kostenloser Plan deckt all dies für bis zu 4 Benutzer ab, was für viele Apiary-Flüchtlinge bedeutet, dass die Migration genau den Nachmittag der Konvertierung kostet.

Wenn Apidog nicht die richtige Wahl ist

Ein ehrlicher Abschnitt, da „Apiary weiterverwenden“ nicht zur Auswahl steht:

• Sie möchten nur Dokumentationsrendering, nichts anderes. Wenn Ihre Spezifikation an anderer Stelle erstellt und getestet wird und Sie lediglich schöne gehostete Dokumente mit Changelog-Tools benötigen, ist ein Docs-First-Produkt wie Bump.sh (dessen Migrationsleitfaden für Apiary-Benutzer wirklich gut ist) eine vernünftige Anlaufstelle. Sie müssen Blueprint trotzdem nach OpenAPI konvertieren, um dorthin zu gelangen.
• Sie standardisieren auf den SmartBear-Stack. SwaggerHub ist der philosophisch nächste Nachkomme von Apiarys gehosteter Spezifikationsregister-Idee. Beachten Sie die Kosten pro Benutzer und die getakteten Testausführungen; wir haben dies in der besten SwaggerHub-Alternative aufgeschlüsselt.
• Ihr Schwerpunkt liegt auf der Design-Governance für ein großes Plattformteam. Stoplight hat umfassende Styleguide- und Governance-Tools entwickelt; sehen Sie sich die beste Stoplight-Alternative an, um zu sehen, wie sie sich vor Ihrer Entscheidung vergleicht.
• Sie sind emotional an API Blueprint gebunden. Verständlich, aber tun Sie es nicht. Die Tools des Formats werden nicht mehr gewartet, das Unternehmen, das es erstellt hat, wird abgeschaltet, und OpenAPI hat gewonnen. Konvertieren Sie es einmal und denken Sie nie wieder darüber nach. Unser älterer Leitfaden zu API Blueprint kann als historische Lektüre verbleiben.

Häufig gestellte Fragen

Wann genau wird Apiary abgeschaltet?

Oracle hat die Beendigung des Apiary-Supports in seinen Foren angekündigt, und aktuelle Berichte von API-Tooling-Anbietern gehen davon aus, dass der gehostete Dienst um September 2026 abgeschaltet wird. Die sichere Annahme ist einfacher: Exportieren Sie jetzt, denn jeder Teil des Produkts wird bereits nicht mehr gepflegt.

Kann Apidog API Blueprint-Dateien direkt importieren?

Nein. Apidog importiert die Formate OpenAPI/Swagger, Postman, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL und Google Discovery. Konvertieren Sie API Blueprint zuerst mit einem Tool wie api-spec-converter oder apib2swagger nach OpenAPI und importieren Sie dann das Ergebnis. Es ist ein einmaliger Schritt, und überprüfen Sie die Authentifizierungsschemata danach manuell.

Was ersetzt den Apiary Mock-Server?

Apidogs integrierter Smart Mock-Server. Wo Apiary die von Ihnen geschriebenen Beispiele abspielte, generiert Apidog automatisch realistische Antworten aus Ihren Schemas, und Sie können benutzerdefinierte Mock-Regeln für spezifische Fälle definieren. Jeder importierte Endpunkt erhält einen Mock-Endpunkt ohne Konfiguration.

Was ersetzt Dredd für Vertragstests?

Apidogs automatisierte Testszenarien: Sie senden echte Anfragen an Ihre Implementierung und validieren Antworten gegen die Schemas Ihrer Spezifikation, mit Assertions und CI-Ausführung über die Apidog CLI. Das deckt Dredds Aufgabe ab, zuzüglich der Testsuite-Funktionen, die Dredd nie hatte.

Ist Apidog für ein kleines Team tatsächlich kostenlos?

Ja. Der kostenlose Plan deckt bis zu 4 Benutzer ab, inklusive Spezifikationseditoren, veröffentlichter interaktiver Dokumentation, Smart Mock-Server und API-Tests. Ab 4 Benutzern kostet es $9 pro Benutzer und Monat, was der niedrigste Preis pro Benutzerplatz unter den ernsthaften Apiary-Migrationszielen ist.

Heute exportieren, nichts neu gestalten

Die Reihenfolge der Operationen ist wichtig: Zuerst aus Apiary exportieren, zweitens Blueprint nach OpenAPI konvertieren und erst dann in Ruhe Ziele bewerten, denn die ersten beiden Schritte haben eine Frist und der dritte nicht. Wenn Sie bereit sind, importieren Sie die OpenAPI-Datei in Apidog und Sie werden Dokumente, Mocks und ein Test-Framework haben, bevor der Nachmittag vorbei ist. Laden Sie Apidog herunter oder starten Sie im Browser; ein Team von 4 Personen zahlt nichts, und der von Apiary erfundene Design-First-Workflow erhält endlich die gewartete Plattform, die er verdient hat.