Использование Postman для использования API соединителей Microsoft Graph

  • Статья

Коллекция Postman Microsoft Graph содержит примеры запросов для API соединителей. Разработчики могут использовать Postman, чтобы опробовать API без написания кода.

Предварительные требования

Запросы API соединителей находятся в папке Application ->Graph Connectors .

Снимок экрана раздела

Создайте новое подключение

Найдите пример запроса Создать подключение в папке Настройка подключения . Используйте этот пример запроса для создания нового подключения. Папка установки подключения также содержит другие примеры запросов для управления подключениями.

Регистрация схемы подключения

Найдите пример запроса Зарегистрировать схему в папке Настройка подключения ->Управление схемой. Используйте этот пример запроса, чтобы зарегистрировать схему для созданного подключения. Этот запрос возвращает ответ, который выглядит следующим образом.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/external/connections/sampleConnectionId/operations/616bfeed-666f-4ce0-8cd9-058939010bfc

Регистрация схемы является асинхронной операцией. URL-адрес, возвращаемый в заголовке Location , следует опрашивировать состояние этой операции до тех пор, пока не будет задано completedзначение . Найдите пример запроса Получить состояние операции в папке Настройка подключения . Замените URL-адрес запроса значением в заголовке Location и отправьте запрос в состояние проверка. Этот запрос возвращает ответ, который выглядит следующим образом.

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "616bfeed-666f-4ce0-8cd9-058939010bfc",
    "name": "Sample connection",
    "status": "inprogress",
    "error": null
}

Повторно отправьте запрос, пока свойству status не будет присвоено значение completed. Подождите по крайней мере одну минуту между повторной отправкой этого запроса.

Папка Управление схемой также содержит другие примеры запросов для управления подключениями.

Добавление члена внешней группы (необязательно)

Если внешняя служба использует списки управления доступом (ACL), не Microsoft Entra ID, синхронизируйте эти разрешения. Внешние группы (наряду с Microsoft Entra ID пользователями и группами) используются для задания разрешений на externalItems добавленные к подключению Microsoft Graph. Дополнительные сведения см. в разделе externalGroup.

Примеры запросов для создания внешних групп и добавления участников находятся в папке Синхронизация удостоверений .

Прием элементов

Примечание.

Не принимать элементы в соединение, пока схема подключения не перейдет в completed состояние .

Найдите пример запроса Put item в папке Синхронизация содержимого . Используйте этот пример запроса для приема элемента. Папка синхронизации содержимого также содержит другие примеры запросов для управления элементами.

Обработка ошибок

Дополнительные сведения об устранении ошибок см. в разделе Устранение ошибок авторизации Microsoft Graph.

Связанные материалы