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

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, инициированных клиентом на стороне Microsoft.

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

Связанное содержимое

Видеоуроки