REST-zu-GraphQL-Mapper
Der REST to GraphQL Mapper erzeugt die mechanische Hälfte des Schemas; die Beziehungen zwischen den Typen zu entwerfen lohnt sich, selbst zu tun.
🔒 Dieses Tool läuft vollständig in Ihrem Browser. Ihre Dateien werden niemals an einen Server hochgeladen.
Entwickler
REST-zu-GraphQL-Mapper
Frontend-Vorschau — kein Upload, kein externer Dienst.
Entwurf des GraphQL-Schemas
Drei Endpunkte werden zu einem User-Typ, einer users-Query, die [User!]! zurückgibt, einer user(id: ID!)-Query und einer createUser-Mutation, die ein CreateUserInput annimmt.
So funktioniert der REST to GraphQL Mapper
- Listen Sie Ihre REST-Endpunkte auf, eine Zeile pro Endpunkt, mit Methode und Pfad.
- Wählen Sie, ob auch Mutations neben Queries generiert werden sollen.
- Behandeln Sie die Ausgabe als ersten Entwurf — der interessante Teil eines GraphQL-Schemas sind die Beziehungen zwischen Typen, die REST-Pfade nicht beschreiben.
FAQ
Kann eine REST-API automatisch konvertiert werden?
Die Endpunktliste gibt Ihnen Queries und Mutations, und das ist die einfache Hälfte. Der Wert von GraphQL liegt im Graphen — wie Typen zusammenhängen — und keine Pfadliste kodiert das. Erwarten Sie, die Beziehungen von Hand zu entwerfen.
Was ist mit dem N+1-Problem?
Ein Schema, das jedes Feld mit einem eigenen REST-Aufruf auflöst, macht eine Anfrage pro Element pro Feld. Das ist die klassische GraphQL-Falle, gelöst durch Batching via DataLoader statt im Schema.
Sollte jeder REST-Endpunkt zu einem Feld werden?
Nein. Eine REST-API hat oft Endpunkte, die die Form von REST umgehen — Massenabrufe, denormalisierte Ansichten, zusammengesetzte Updates. Die verschwinden meist in einem gut entworfenen Graphen.
Vergleich
| Funktion | Online Tool Store | Ein CLI-Skript | Ein IDE-Plugin |
|---|---|---|---|
| Queries und Mutations | ✓ | ✗ | ✓ |
| Nichts wird hochgeladen | ✓ | Lokal | ✗ |
| Schlägt Input-Typen vor | ✓ | ✗ | ✓ |
| Keine Installation | ✓ | ✗ | ✗ |
Der REST to GraphQL Mapper erzeugt die mechanische Hälfte des Schemas; die Beziehungen zwischen den Typen zu entwerfen lohnt sich, selbst zu tun.