API исполнения SaaS на коммерческой платформе Майкрософт
API исполнения SaaS позволяют издателям, также называемым независимыми поставщиками программного обеспечения, публиковать и продавать свои приложения SaaS в Microsoft AppSource, Azure Marketplace и на портале Azure. Эти API позволяют приложениям независимых поставщиков участвовать во всех каналах с поддержкой продаж: прямой, под управлением партнера (торгового посредника) и с продажами на местах. Интеграция с этими API является обязательным требованием для создания и публикации предложения SaaS в Центре партнеров.
Чтобы узнать об API выполнения SaaS, мы рекомендуем также ознакомиться со следующими статьями:
- Управление жизненным циклом подписки SaaS
- API подписки SaaS версии 2
- API операций выполнения SaaS версии 2
- Реализация веб-перехватчика в службе SaaS
- Распространенные вопросы об API выполнения SaaS
Потоки API
Независимые поставщики должны реализовывать перечисленные ниже потоки API, добавляя их в код службы SaaS для синхронизации состояния подписки как для поставщика, так и Майкрософт.
- Поток целевой страницы: Корпорация Майкрософт уведомляет издателя о том, что предложение SaaS издателя было приобретено клиентом в Marketplace.
- Поток активации: издатель уведомляет Майкрософт о том, что недавно приобретенная учетная запись SaaS была настроена на стороне издателя.
- Поток обновления: изменение приобретенного плана или количества приобретенных мест или обоих.
- Приостановка и восстановление потока: приостановка приобретенного предложения SaaS в случае, если метод оплаты клиента больше не действителен. Приостановленное предложение можно возобновить после устранения проблемы со способом оплаты.
- Потоки веб-перехватчика: корпорация Майкрософт уведомляет издателя об изменениях подписки SaaS и отмене, инициированных клиентом с стороны Майкрософт.
Для отмены приобретенной подписки на SaaS интеграция не является обязательной, так как она может быть выполнена клиентом на стороне Майкрософт.
Для обеспечения правильной интеграции с API-интерфейсами выполнения SaaS важно убедиться в том, что:
- Конечные клиенты, которые приобрели предложение SaaS издателя, оплачиваются корпорацией Майкрософт правильно.
- Конечные клиенты получают правильную покупку, настройку, использование и управление подписками SaaS, приобретенными в Marketplace.
Эти API позволяют издателю принимать участие во всех каналах с поддержкой продаж:
- Напрямую
- Партнерская среда (торговый посредник, поставщик облачных решений [CSP])
- Полевой индикатор
В сценарии с торговым посредником (CSP) CSP приобретает предложение SaaS от имени конечного клиента. Ожидается, что клиент будет использовать предложение SaaS, но CSP — это сущность, которая выполняет следующие задачи:
- Выставление счетов клиенту
- Изменение планов подписки и объема приобретенных мест
- Отменяет подписки
Издателю не требуется реализовать потоки вызовов API по-разному для этого сценария.
Дополнительные сведения см. в разделе поставщик облачных решений (CSP).
Предупреждение
API-интерфейсы выполнения SaaS версии 1 устарели; вместо этого используйте версию 2. Версия 1 в настоящее время поддерживается только для обслуживания существующих издателей, а документация по версии 1 больше недоступна. Если вы чувствуете, что вам нужно получить доступ к нему, вы можете отправить сообщение электронной почты saas-api-v1@microsoft.com.
Примечание.
API исполнения SaaS должны вызываться только из внутренней (серверной) системы издателя. Интеграция с API непосредственно с веб-страницы издателя не поддерживается. Следует использовать только поток проверки подлинности "служба — служба".
Связанный контент
- Если вы еще этого не сделали, зарегистрируйте приложение SaaS в портал Azure, как описано в разделе "Регистрация приложения Microsoft Entra". После этого используйте самую последнюю версию этого интерфейса для разработки: API-интерфейсы подписки SaaS для выполнения версии 2 и API операций выполнения SaaS версии 2.
Видеоучебники