API исполнения SaaS на коммерческой платформе Майкрософт

  • Статья

API исполнения SaaS позволяют издателям, также называемым независимыми поставщиками программного обеспечения, публиковать и продавать свои приложения SaaS в Microsoft AppSource, Azure Marketplace и на портале Azure. Эти API позволяют приложениям независимых поставщиков участвовать во всех каналах с поддержкой продаж: прямой, под управлением партнера (торгового посредника) и с продажами на местах. Интеграция с этими API является обязательным требованием для создания и публикации предложения 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 см. в статье https://partner.microsoft.com/licensing.

Предупреждение

Текущей версией этого API является версия 2, которую следует использовать для всех новых предложений SaaS. Версия 1 API устарела и поддерживается для работы с существующими предложениями.

Примечание.

API исполнения SaaS должны вызываться только из внутренней (серверной) системы издателя. Интеграция с API непосредственно с веб-страницы издателя не поддерживается. Следует использовать только поток проверки подлинности "служба — служба".

Следующие шаги

Видеоучебники