Eine API-Referenzspezifikation ersetzen
Durch das Ersetzen der Spezifikation wird eine API-Referenz auf eine neue Quelle umgestellt: eine hochgeladene Datei, eine URL oder ein GitHub-Repository. Die Referenz wird zur Verarbeitung zurückgesetzt und anhand der neuen Spezifikation neu indiziert. Ihre Vorgaben für Operationen und Layout bleiben beim Wechsel erhalten.
Spezifikation ersetzen
Gehen Sie im Dashboard zum Help Center und klicken Sie im Inhaltsbaum auf die API-Referenz.
Wählen Sie im Detailbereich den Tab Source aus.
Klicken Sie auf Replace spec.
Wählen Sie den Typ der neuen Quelle aus und geben Sie die Datei, URL oder den GitHub-Speicherort an.
Zum Erstellen, Ersetzen und Veröffentlichen einer API-Referenz ist ein aktives oder sich in der Testphase befindendes Abonnement erforderlich.
Was als gültige Spezifikation gilt
Der Parser unterstützt OpenAPI, Swagger 2.0, GraphQL SDL und GraphQL-Introspektions-JSON.
Eine Spezifikation mit einer Größe von mehr als 15 MB wird abgelehnt.
Wie es weitergeht
Wenn die neue Quelle eine URL oder GitHub ist, halten Sie sie unter API-Referenzquellen aktualisieren aktuell.