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


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

API выполнения SaaS позволяют издателям, также известным как независимые поставщики программного обеспечения (ISV), публиковать и продавать свои приложения SaaS в Microsoft AppSource, Azure Marketplace и на портале Azure. Эти API позволяют приложениям ISV участвовать во всех включенных в коммерческий оборот каналах: прямых, партнерских (реселлерских) и под руководством полевых сотрудников. Интеграция с этими API является обязательным требованием для создания и публикации транзакционного предложения SaaS в Центре партнеров.

Чтобы узнать об API выполнения SaaS, мы рекомендуем также ознакомиться со следующими статьями:

Потоки API

ISV должны реализовать следующие API-потоки, добавив их в код их службы SaaS, чтобы поддерживать одинаковый статус подписки как для ISV, так и для Microsoft.

  • поток целевой страницы: корпорация Майкрософт уведомляет издателя о том, что предложение SaaS издателя было приобретено клиентом на маркетплейсе.
  • поток активации: издатель уведомляет Майкрософт о том, что недавно приобретенная учетная запись 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 непосредственно с веб-страницы издателя не поддерживается. Следует использовать только поток проверки подлинности между службами.

Видеоуроки