Arbeta med flera versioner

API Designer låter dig arbeta med flera versioner av samma API-definition för att hjälpa dig hantera din API-livscykel. Du kan:

Behålla en befintlig API-version i produktion samtidigt som du introducerar betydande eller brytande ändringar i en ny version.
Få synlighet och kontroll över publicerade versioner.
Få flexibilitet när du utformar ändringar i ett API.

När du skapar en ny version av ett API kopieras allt innehåll till den nya versionen och varje version kan sedan ändras oberoende av varandra utan att påverka de andra.

API Designer-startsidan visar alla API:er som ägs av dig och alla API-versioner som delas med dig.

Skapa en ny API-version

Skapa en ny version av en befintlig API-definition.

Du är ägare till API:et eller redigerare för minst en version av API:et.

På startsidan går du till det API som du vill skapa en ny version för.
Du kan filtrera listan efter namn eller ägare vid behov.
Klicka på knappen bredvid den version som du vill kopiera och klicka på Skapa en ny version från <version>.
Ange den nya versionen.
Klicka på Skapa.

En ny version av ditt API skapas med samma innehåll som källversionen. Mocken och dokumentationen är inaktiverade som standard.

Ta bort en API-version

Du är ägare till API:et.

På startsidan klickar du på knappen bredvid den version som du vill ta bort och klickar på Ta bort.
Klicka på Ta bort för att bekräfta.

Den valda versionen tas bort. Om du vill ta bort ett helt API måste du ta bort varje version.

Importera versionsinnehåll

Importera innehåll från ett befintligt kontrakt till en API-version, och ersätt eller slå samman dess nuvarande innehåll.

Du är ägare till API:et eller redigerare för API-versionen.

Använd den här funktionen för att uppdatera en version från en extern kontraktsfil utan att skapa en ny version. Versionsidentifieraren bevaras under hela importen.

Detta skiljer sig från att importera en definition, vilket skapar ett nytt API i API Designer.

Öppna Importera versionsinnehåll för den version du vill uppdatera.
Du kan komma åt den här åtgärden från följande platser:
- På startsidan klickar du på menyknappen bredvid versionen och klickar på Importera versionsinnehåll.
- På startsidan väljer du versionen för att öppna detaljrutan och klickar sedan på Importera versionsinnehåll.
- I versionsredigeraren klickar du på Redigera > Importera versionsinnehåll.
Välj ett format och en källa för kontraktet som ska importeras.
Du kan importera från en lokal fil, en URL eller text som du klistrar in direkt i dialogrutan.
Under Beteende väljer du hur det importerade innehållet ska tillämpas.
- Ersätt: skriver över allt nuvarande innehåll med det importerade kontraktet. API-namnet, versionsidentifieraren och specifikationsversionen bevaras.
- Slå samman: kombinerar det importerade innehållet med det befintliga versionsinnehållet. API-namnet och versionsidentifieraren bevaras. Om ett importerat element har samma namn som ett befintligt element byter det importerade elementet namn med ett _merge-suffix (till exempel User_merge). Duplicerade bas-URL:er och medietyper hoppas över.
Klicka på Importera.

Versionsredigeraren öppnas med det uppdaterade innehållet tillämpat.

Var den här sidan till hjälp för dig?

Om du stöter på några problem med den här sidan eller innehållet på den, t.ex. ett stavfel, ett saknat steg eller ett tekniskt fel – meddela oss!

Lämna din feedback här