Simulation erstellen
Eine neue Simulation ist ein Behälter mit eigener URL und noch ohne Inhalt. Das Erstellen liefert nichts aus; Endpunkte erscheinen unter der URL erst nach einem Deploy.
Wege zu starten
Öffne Simulationen und klicke Neue Simulation, um leer zu starten, oder wähle über den Pfeil daneben einen anderen Einstieg:
- Leere Simulation beginnt bei null; Endpunkte und Specs fügst du selbst hinzu.
- Beispiel-Simulation erstellen kommt vorbefüllt mit der Petstore-Spec und ein paar statischen Endpunkten. Der Quickstart führt hindurch.
- Katalog durchsuchen startet mit einer kuratierten API: Stripe, Twilio, Auth0 und mehr. Siehe Aus dem Katalog starten.
- Backend-Sandbox ist eine andere Art Simulation: ein Zahlungs- oder Identitätsanbieter als deine eigene Sandbox. Siehe Sandbox erstellen.
Deine eigene OpenAPI-Spec fügst du in der Simulation hinzu, sobald sie existiert, egal wie du gestartet bist.
Siehe OpenAPI-Spec hochladen und aktualisieren.
Eine Simulation lässt sich auch direkt aus einem GitHub-Repo deployen, mit einer URL pro Branch und Pull Request.
Siehe GitHub Action.
Name, Domain und Slug
Der leere Start öffnet diesen Dialog:
- Name ist der Anzeigename in Listen. Du kannst ihn jederzeit ändern.
- Domain bestimmt, welchen API-Host die URL der Simulation nutzt. Die Vorgabe passt.
- Slug wird Teil der URL:
<domain>/app/<deine-org>/<slug>. Kleinbuchstaben, Ziffern und Bindestriche, kurz gehalten; das Formular prüft die Verfügbarkeit beim Tippen.
Eine deployte Simulation kann ihren Slug nicht ändern. Nimm sie zuerst offline, benenne sie um und deploye erneut.
Nach dem Erstellen
Die Simulation öffnet sich in der Endpunkte-Ansicht. Noch wird nichts ausgeliefert: Lege fest, was sie antworten soll, und klicke dann Deploy, um sie unter ihrer URL live zu nehmen.
Siehe Deploy und URLs.