Praca z wieloma wersjami

API Designer pozwala na pracę z kilkoma wersjami tej samej definicji API, aby pomóc w zarządzaniu cyklem życia API. Możesz:

Utrzymywać istniejącą wersję API w środowisku produkcyjnym, wprowadzając jednocześnie znaczące lub przełomowe zmiany w nowej wersji.
Zyskać widoczność i kontrolę nad opublikowanymi wersjami.
Zyskać elastyczność podczas projektowania zmian w API.

Po utworzeniu nowej wersji API cała zawartość jest kopiowana do nowej wersji, a każdą wersję można następnie modyfikować niezależnie, bez wpływu na pozostałe.

Strona główna API Designer wyświetla wszystkie API, których jesteś właścicielem, oraz wszystkie wersje API udostępnione Tobie.

Tworzenie nowej wersji API

Utwórz nową wersję istniejącej definicji API.

Jesteś właścicielem API lub edytorem co najmniej jednej wersji API.

Na stronie głównej przejdź do API, dla którego chcesz utworzyć nową wersję.
W razie potrzeby możesz filtrować listę według nazwy lub właściciela.
Kliknij przycisk obok wersji, którą chcesz skopiować, a następnie kliknij Utwórz nową wersję z <version>.
Wprowadź nową wersję.
Kliknij Utwórz.

Zostanie utworzona nowa wersja Twojego API z taką samą zawartością jak wersja źródłowa. Makieta i dokumentacja są domyślnie wyłączone.

Usuwanie wersji API

Jesteś właścicielem API.

Na stronie głównej kliknij przycisk obok wersji, którą chcesz usunąć, a następnie kliknij Usuń.
Kliknij Usuń, aby potwierdzić.

Wybrana wersja zostanie usunięta. Jeśli chcesz usunąć całe API, musisz usunąć każdą wersję.

Importowanie zawartości wersji

Importuj zawartość z istniejącego kontraktu do wersji API, zastępując lub scalając jej obecną zawartość.

Jesteś właścicielem API lub edytorem wersji API.

Użyj tej cechy, aby zaktualizować wersję z zewnętrznego pliku kontraktu bez tworzenia nowej wersji. Identyfikator wersji jest zachowywany podczas całego importu.

Różni się to od importowania definicji, które tworzy nowe API w API Designer.

Otwórz Importuj zawartość wersji dla wersji, którą chcesz zaktualizować.
Możesz uzyskać dostęp do tej akcji z następujących lokalizacji:
- Na stronie głównej kliknij przycisk menu obok wersji i kliknij Importuj zawartość wersji.
- Na stronie głównej wybierz wersję, aby otworzyć okienko szczegółów, a następnie kliknij Importuj zawartość wersji.
- W edytorze wersji kliknij Edytuj > Importuj zawartość wersji.
Wybierz format i źródło dla kontraktu do zaimportowania.
Możesz importować z pliku lokalnego, adresu URL lub tekstu wklejonego bezpośrednio do okna dialogowego.
W sekcji Zachowanie wybierz sposób zastosowania zaimportowanej zawartości.
- Zastąp: nadpisuje całą obecną zawartość zaimportowanym kontraktem. Nazwa API, identyfikator wersji i wersja specyfikacji są zachowywane.
- Scal: łączy zaimportowaną zawartość z istniejącą zawartością wersji. Nazwa API i identyfikator wersji są zachowywane. Jeśli zaimportowany element ma taką samą nazwę jak istniejący element, zaimportowany element zostaje zmieniony poprzez dodanie sufiksu _merge (na przykład User_merge). Zduplikowane podstawowe adresy URL i typy mediów są pomijane.
Kliknij Importuj.

Edytor wersji zostanie otwarty z zastosowaną zaktualizowaną zawartością.

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać!

Przekaż tu opinię