API-интерфейсы выполнения SaaS на коммерческой платформе Майкрософт
API выполнения SaaS позволяют издателям, также известным как независимые поставщики программного обеспечения (ISV), публиковать и продавать свои приложения SaaS в Microsoft AppSource, Azure Marketplace и на портале Azure. Эти API позволяют приложениям ISV участвовать во всех включенных в коммерческий оборот каналах: прямых, партнерских (реселлерских) и под руководством полевых сотрудников. Интеграция с этими API является обязательным требованием для создания и публикации транзакционного предложения SaaS в Центре партнеров.
Чтобы узнать об API выполнения SaaS, мы рекомендуем также ознакомиться со следующими статьями:
- Управление жизненным циклом подписки SaaS
- API подписок SaaS версии 2
- API операций выполнения SaaS версии 2
- Реализация вебхука в сервисе 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 непосредственно с веб-страницы издателя не поддерживается. Следует использовать только поток проверки подлинности между службами.
Связанное содержимое
- Если вы еще этого не сделали, зарегистрируйте ваше приложение SaaS на портале Azure , как описано в «Зарегистрируйте приложение Microsoft Entra».
- Затем используйте самую последнюю версию этого интерфейса для разработки: API выполнения подписки SaaS версии 2 и API операций выполнения SaaS версии 2.
Видеоуроки