Rozhraní API pro plnění SaaS na komerčním marketplace 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 výrobců softwaru účastnit se všech kanálů s podporou obchodování: přímé, partnerské (prodejce) a řízené polem. 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
- Rozhraní API předplatného plnění SaaS v2
- Rozhraní API pro operace plnění SaaS v2
- Implementace webhooku ve službě SaaS
- Běžné dotazy k rozhraním API pro plnění SaaS
Toky rozhraní API
Nezávislí výrobci softwaru musí implementovat následující toky rozhraní API přidáním kódu služby SaaS, aby zachovali stejný stav předplatného pro nezávislé výrobce softwaru a Microsoft:
- Tok cílové stránky: Microsoft upozorní vydavatele, že nabídku SaaS vydavatele zakoupil zákazník na marketplace.
- Tok aktivace: Publisher 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 licencí nebo obojího.
- 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 upozorní vydavatele na změny předplatného SaaS a zrušení aktivované 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í:
- Direct
- Vedoucí partner (prodejce, Cloud Solution Provider [CSP])
- Led pole
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 množství zakoupených licencí.
- Zruší předplatná.
Pro tento scénář není nutné implementovat žádný tok volání rozhraní API jinak.
Další informace najdete v tématu Cloud Solution Provider (CSP).
Upozorňující
Rozhraní API pro plnění SaaS verze 1 byla zastaralá; místo toho použijte V2. 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 němu potřebujete přístup, můžete e-mail 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 části Registrace aplikace Microsoft Entra. Následně 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.
Videonávody