Поделиться через


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).

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

API-интерфейсы выполнения SaaS версии 1 устарели; вместо этого используйте версию 2. Версия 1 в настоящее время поддерживается только для обслуживания существующих издателей, а документация по версии 1 больше недоступна. Если вы чувствуете, что вам нужно получить доступ к нему, вы можете отправить сообщение электронной почты saas-api-v1@microsoft.com.

Примечание.

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

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