Usar o Postman para experimentar a API de conectores do Microsoft Graph

A coleção Do Microsoft Graph Postman inclui solicitações de exemplo para a API de conectores. Os desenvolvedores podem usar o Postman para experimentar a API sem escrever nenhum código.

Pré-requisitos

• Bifurque a coleção postman do Microsoft Graph.
• Adicione as ExternalConnection.ReadWrite.OwnedBy permissões e ExternalItem.ReadWrite.OwnedBy ao registro do aplicativo criado para o Postman.
• Use o Postman para autenticar com autenticação somente aplicativo.

As solicitações de API dos conectores estão localizadas na pasta Conectoresdo Aplicativo ->Graph.

Criar uma nova conexão

Encontre a solicitação Criar exemplo de conexão na pasta Configuração de conexão . Use essa solicitação de exemplo para criar uma nova conexão. A pasta Configuração de conexão também contém outras solicitações de exemplo para o gerenciamento de conexões.

Registrar esquema de conexão

Localize a solicitação de exemplo de esquema Registrar na pasta Configuração de conexão ->Gerenciar esquema . Use essa solicitação de exemplo para registrar um esquema para a conexão que você criou. Essa solicitação retorna uma resposta que se parece com a seguinte.

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

Registrar um esquema é uma operação assíncrona. A URL retornada no Location cabeçalho deve ser votada para o status desta operação até que o status seja completed. Localize a solicitação de exemplo Obter operação status na pasta Configuração de conexão. Substitua a URL de solicitação pelo valor no Location cabeçalho e envie a solicitação para marcar status. Essa solicitação retorna uma resposta que se parece com a seguinte.

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

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

Reenviar a solicitação até que a status propriedade seja definida como completed. Aguarde pelo menos um minuto entre reenviar essa solicitação.

A pasta Gerenciar esquema também contém outras solicitações de exemplo para gerenciar conexões.

Adicionar membro do grupo externo (opcional)

Se o serviço externo usar ACLs (listas de controle de acesso não Microsoft Entra ID), sincronize essas permissões. Grupos externos (juntamente com Microsoft Entra ID usuários e grupos) são usados para definir permissões adicionadas externalItems a uma conexão do Microsoft Graph. Para obter detalhes, consulte externalGroup.

Solicitações de exemplo para criar grupos externos e adicionar membros estão localizadas na pasta Sincronização de Identidade .

Ingerir itens

Observação

Não ingera itens na conexão até que o esquema de conexão esteja no completed estado.

Localize a solicitação de exemplo Colocar item na pasta Sincronização de conteúdo . Use essa solicitação de exemplo para ingerir um item. A pasta Sincronização de conteúdo também contém outras solicitações de exemplo para o gerenciamento de itens.

Tratamento de erro

Para obter detalhes sobre como resolver erros, consulte Resolver erros de autorização do Microsoft Graph.

Conteúdo relacionado

• Use o Postman com a API do Microsoft Graph