Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
Ovaj članak daje pregled izrade verzija i kršenja pravila promjena za različite alate za programiranje.
Podrška i informacije o zastarjevanju
Kako se objavi nova verzija REST API-ja, starije se verzije umirovljene. Microsoft deklarira verziju zastarjelu najmanje 12 mjeseci prije povlačenja krajnje točke API-ja. Kada se verzija zastari, podržana je as-is. Ako se suočite s problemom s tom verzijom, zahtijevamo da prijeđite na trenutno stabilnu verziju. Kada se verzija povuče iz upotrebe, ona nije podržana i uskoro će se isključiti.
Povećanjem broja verzije API-ja (na primjer, s 2021-10-01 na 2022-04-01) Microsoft objavljuje se da je prethodna općenito dostupna verzija (u ovom primjeru 2021-10-01) odmah zastarjela i da će biti povučena 12 mjeseci nakon najave. Microsoft može napraviti iznimke od ovog pravilnika za probleme sa zdravljem i sigurnošću usluge.
Razni alati i SDK-ovi generirani na temelju API-ja za Power Platform kao što su Power Platform CLI, poveznik za administratore V2 i PowerShell ažuriraju se na novije verzije API-ja za pojedinačne radnje i transparentni su za krajnje korisnike.
Kompatibilne i prijelomne promjene
Microsoft pruža pojedinosti o promjenama programibilnost u planovima izdanja. Ako promjene po prirodi nerastavljaju, verzija API-ja ostaje ista, a verzija komponente PowerShell primit će pomak radne verzije. Ako se promjene ne mijenjaju, Microsoft povećava verziju API-ja i glavnu verziju komponente PowerShell.
Evo primjera prijelomnih promjena:
- URL ili temeljni zahtjev / odgovor se mijenja.
- Deklarirano svojstvo se uklanja ili preimenuje ili se mijenja njegova vrsta.
- API ili API parametri uklanjaju se ili preimenuju.
- Dodaje se obavezan parametar zahjteva.
Evo primjera nerastavljajućih promjena:
- Dodaju se svojstva koja se mogu poništiti ili imaju zadanu vrijednost.
- Član se dodaje na enumeraciji.
- Označavanje stranica predstavljeno postojećim zbirkama.
- Kodovi pogrešaka se mijenjaju.
- Redoslijed svojstava u zahtjevima ili odgovorima se mijenja.
Available versions
| Version | Type | Reference | Deprecation date | Decommission date |
|---|---|---|---|---|
| 2024-10-01 | Stable | Reference | N/A | N/A |
| 2020-10-01 | Generally available | 2020-10-01 Ref | N/A | N/A |
Note
Općenito dostupna verzija Power Platform API-ja iz 2020-10-01 specifična je za upravljanje okolišem i često se naziva i Business Application Platform (BAP) API. Funkcionalnost ovog skupa krajnjih točaka dostupna je u novijim verzijama Power Platform API-ja.
Next steps
Sad kad razumijete strategiju izrade verzija i podrške, prođimo kroz postupak provjere autentičnosti pomoću API-ja za Microsoft Power Platform.