create-api.dev by Kong

create-api.dev ist ein KI-Werkzeug von Kong, dem Unternehmen hinter Kong Gateway und Insomnia. Der Kong OpenAPI-Builder wandelt die schriftliche Beschreibung einer API in eine funktionierende OpenAPI-Spezifikation um, die Standarddatei, die Tools zeigt, wie Endpunkte, Parameter und Antworten zusammenpassen. Sie schreiben das YAML nicht per Hand. Sie erklären, was die API tun soll, und der Builder entwirft die Spec für Sie. In der Praxis wirkt das Ergebnis wie eine KI-generierte API-Spezifikation, die Sie bearbeiten können, nicht wie ein fertiger Vertrag, dem Sie blind vertrauen.

Das Werkzeug läuft als Projekt von Kong Labs. Das heißt: Es ist eine experimentelle Vorschau, kein voll unterstütztes Produkt. Kong kann es jederzeit ändern oder abschalten, und es gibt weder eine Verfügbarkeitszusage noch einen offiziellen Supportkanal. Es nutzt zudem die Sprachmodelle von Google, sodass Ihre Eingaben und die Ergebnisse über einen Drittanbieter laufen.

Die wichtigste Einschränkung ist die Genauigkeit. Eine von KI entworfene Spec sieht vollständig aus, kann aber falsche Feldtypen, fehlende Sonderfälle oder erfundene Beispiele enthalten. Behandeln Sie das Ergebnis als guten ersten Entwurf, den Sie noch Zeile für Zeile prüfen sollten, bevor jemand darauf aufbaut.

Getting Started

1. Öffnen Sie create-api.dev im Browser und starten Sie eine Sitzung. Eine Installation oder ein Anmeldeformular ist vorab nicht nötig.
2. Beschreiben Sie die API in normaler Sprache: was sie tut, welche Endpunkte es gibt und was jeder annimmt und zurückgibt.
3. Senden Sie die Beschreibung und lassen Sie den Builder daraus eine OpenAPI-Spezifikation entwerfen.
4. Prüfen Sie das Ergebnis. Kontrollieren Sie Pfade, Methoden, Parameter und Antwortformate und fordern Sie dann Änderungen in weiteren Nachrichten an.
5. Exportieren oder kopieren Sie die fertige Spec in Ihr Repository und laden Sie sie in Insomnia, Swagger UI oder Ihre eigene Pipeline.