Uso de Postman para probar la API de conectores de Microsoft Graph

La colección Microsoft Graph Postman incluye solicitudes de ejemplo para la API de conectores. Los desarrolladores pueden usar Postman para probar la API sin escribir ningún código.

Requisitos previos

• Bifurca la colección Microsoft Graph Postman.
• Agregue los ExternalConnection.ReadWrite.OwnedBy permisos y ExternalItem.ReadWrite.OwnedBy al registro de la aplicación creado para Postman.
• Use Postman para autenticarse con la autenticación de solo aplicación.

Las solicitudes de API de conectores se encuentran en la carpeta Application ->Graph Connectors .

Creación de una conexión

Busque la solicitud Crear ejemplo de conexión en la carpeta Configuración de conexión . Use esta solicitud de ejemplo para crear una nueva conexión. La carpeta Configuración de conexión también contiene otras solicitudes de ejemplo para administrar conexiones.

Registro del esquema de conexión

Busque la solicitud de ejemplo Registrar esquema en la carpeta Configuración de conexión ->Administrar esquema . Use esta solicitud de ejemplo para registrar un esquema para la conexión que ha creado. Esta solicitud devuelve una respuesta similar a la siguiente.

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

Registrar un esquema es una operación asincrónica. La dirección URL devuelta en el Location encabezado debe sondear el estado de esta operación hasta que el estado sea completed. Busque la solicitud de ejemplo Obtener estado de la operación en la carpeta Configuración de conexión . Reemplace la dirección URL de la solicitud por el valor en el Location encabezado y envíe la solicitud para comprobar el estado. Esta solicitud devuelve una respuesta similar a la siguiente.

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

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

Vuelva a enviar la solicitud hasta que la status propiedad se establezca en completed. Espere al menos un minuto entre volver a enviar esta solicitud.

La carpeta Administrar esquema también contiene otras solicitudes de ejemplo para administrar conexiones.

Agregar miembro de grupo externo (opcional)

Si el servicio externo usa listas de control de acceso (ACL) que no son Microsoft Entra ID, sincronice esos permisos. Los grupos externos (junto con Microsoft Entra ID usuarios y grupos) se usan para establecer permisos al externalItems agregar a una conexión de Microsoft Graph. Para obtener más información, vea externalGroup.

Las solicitudes de ejemplo para crear grupos externos y agregar miembros se encuentran en la carpeta Identity Sync .

Ingerir elementos

Nota:

No ingiera elementos en la conexión hasta que el esquema de conexión esté en el completed estado .

Busque la solicitud put item sample en la carpeta Sincronización de contenido . Use esta solicitud de ejemplo para ingerir un elemento. La carpeta Sincronización de contenido también contiene otras solicitudes de ejemplo para administrar elementos.

Control de errores

Para obtener más información sobre cómo resolver errores, consulte Resolver errores de autorización de Microsoft Graph.

Contenido relacionado

• Usar Postman con la API de Microsoft Graph