Rozhraní API pro realizaci SaaS v komerčním trhu Microsoftu
Rozhraní API saaS Fulfillment umožňují vydavatelům, označovaným také jako nezávislí dodavatelé softwaru (ISV), publikovat a prodávat své aplikace SaaS v Microsoft AppSource, Azure Marketplace a na webu Azure Portal. Tato rozhraní API umožňují aplikacím nezávislých dodavatelů softwaru účastnit se všech obchodních kanálů: přímých, partnerských (prodejních) a řízených v terénu. Integrace s těmito rozhraními API je požadavek na vytvoření a publikování nabídky SaaS s možností transakce v Partnerském centru.
Pokud se chcete dozvědět o rozhraních API pro plnění SaaS, doporučujeme také přečíst následující články:
- správa životního cyklu předplatného SaaS
- SaaS API pro vyřizování předplatných v2
- rozhraní API pro operace plnění SaaS v2
- Implementace webhooku ve službě SaaS
- nejčastější dotazy k rozhraním API pro plnění SaaS
Toky rozhraní API
Nezávislí poskytovatelé softwaru (ISV) musí implementovat následující toky rozhraní API tím, že je začlení do kódu své služby SaaS, aby udrželi stejný stav předplatného pro ISV a Microsoft.
- Průběh cílové stránky: Microsoft upozorní vydavatele, že nabídku SaaS vydavatele zakoupil zákazník na tržišti.
- tok aktivace: Vydavatel oznámí Microsoftu, že na straně vydavatele byl nakonfigurovaný nově zakoupený účet SaaS.
- tok aktualizace: Změna zakoupeného plánu nebo počtu zakoupených míst nebo obojí.
- pozastavení a obnovení toku: Pozastavení zakoupené nabídky SaaS v případě, že už není platný způsob platby zákazníka. Pozastavenou nabídku je možné obnovit, když se vyřeší problém s způsobem platby.
- toky Webhooku: Microsoft informuje vydavatele o změnách předplatného SaaS a zrušení aktivovaných zákazníkem ze strany Microsoftu.
Pro zrušení zakoupeného předplatného SaaS je integrace volitelná, protože ji může provést zákazník na straně Microsoftu.
Správná integrace s rozhraními API saaS Fulfillment je důležitá pro zajištění, že:
- Koncoví zákazníci, kteří si koupili nabídku SaaS vydavatele, se Microsoftu účtují správně.
- Koncoví zákazníci získávají správné uživatelské prostředí při nákupu, konfiguraci, používání a správě předplatných SaaS zakoupených na marketplace.
Tato rozhraní API umožňují, aby se nabídky vydavatele mohly účastnit všech kanálů s podporou obchodování:
- Přímý
- Partnerem vedené (prodejce, Cloud Solution Provider [CSP])
- Řízené praxí
Ve scénáři prodejce (CSP) si poskytovatel CSP koupí nabídku SaaS jménem koncového zákazníka. Očekává se, že zákazník bude používat nabídku SaaS, ale poskytovatel CSP je entita, která provádí následující úlohy:
- Fakturuje zákazníka.
- Změní plány předplatného nebo počet zakoupených míst.
- Zruší předplatná.
Pro tento scénář není vydavatel povinen implementovat žádný z toků volání rozhraní API jinak.
Další informace naleznete v části Poskytovatel cloudových řešení (CSP).
Důležitý
Rozhraní API pro plnění SaaS verze 1 byla zrušena; místo ní použijte verzi 2. V1 se v současné době udržuje jenom pro obsluhu stávajících vydavatelů a dokumentace pro V1 už není dostupná. Pokud máte pocit, že k tomu potřebujete přístup, můžete napsat e-mail na saas-api-v1@microsoft.com.
Poznámka
Rozhraní API pro plnění SaaS mají být volána pouze z back-endové služby vydavatele. Integrace s rozhraními API přímo z webové stránky vydavatele se nepodporuje. Měli byste použít pouze tok ověřování mezi službami.
Související obsah
- Pokud jste to ještě neudělali, zaregistrujte aplikaci SaaS na webu Azure Portal, jak je vysvětleno v tématu Registrace aplikace Microsoft Entra.
- Poté použijte nejnovější verzi tohoto rozhraní pro vývoj: rozhraní API předplatného plnění SaaS verze 2 a rozhraní API operací plnění SaaS v2.
Videokursy