Probar las peticiones con Postman

Introducción

Una vez generada la aplicación en Sharepoint y asignado los permisos ( Proporcionar los permisos a la aplicación ) para poder realizar las peticiones a la API de Sharepoint, podemos probar la autenticación y las demás consultas a la API usando la colección de Postman:

Configuración del entorno

Necesitamos un entorno con las siguientes variables:

• BaseUrl: Host del tenant de sharepoint 365.

• Site: Path del site de sharepoint al que queramos apuntar.

• Client ID: Id del cliente de autenticación

• Secret: Secreto del cliente de autenticación.

Un ejemplo de estas variables sería:

Open

Para poder crear estas variables tenemos que crearnos un entorno (enviroment). Deberemos seleccionar la pestaña Enviroments y darle a crear, como podemos ver en la siguiente imagen:

Open

Una vez se haya creado el entorno, debemos crear las 4 variables citadas anteriormente. Las variables son: BaseUrl, Site, Client ID y Secret.

Tendremos que activar el entorno como en la siguiente imagen:

Operaciones

A continuación detallamos las operaciones necesarias para completar la parametrización del repositorio en SAP.

1. Recuperar el TenantID y Audience

Para recuperar el TenantID (necesario en la parametrización) lanzaremos la petición de la colección llamada Recuperar el TenantID y Audience, tras ejecutar la petición se crearán automáticamente 2 nuevas variables en el entorno necesarias en la parametrización:

• Tenant ID: ID del Tenant de Sharepoint 365, en otras palabras, el ID de nuestro Sharepoint.

• Audience: ID de la audiencia, un campo con valor fijo necesario para la recuperación del Token de autenticación, para versiones modernas ya no es necesario.

Una creadas estas 2 variables, junto con las variables Client ID y Secret, ya podemos generar el token de autenticación para el resto de peticiones.

La respuesta de esta llamada nos dará lo siguiente:

Si volvemos al entorno se habrán creado las dos nuevas variables:

2. Validar la generación del token

Para recuperar el token de sesión lanzaremos la petición de la colección, llamada Recuperar el token, al ejecutar la petición se creará una nueva variable de entorno llamada Token, que es la que se usará para ejecutar el resto de peticiones. El hecho de que se cree correctamente, implica que los valores BaseUrl, Client ID, Secret, Tenant ID y Audience son correctos.

La respuesta nos deberá dar un 200, como podemos ver en la siguiente imagen:

Una vez se haya ejecutado esta petición podremos irnos a las variables de la colección y comprobar que el token se ha rellenado:

3. Comprobar si el Site existe.

Para comprobar que el site existe ejecutaremos la petición Comprueba existe Site que tras ejecutarse deberá devolver un estado 200 OK e información relativa al site. Si devuelve un 404 probablemente el site esté mal escrito, comprobar que esté bien escrito.

La respuesta de esta petición debera ser un 200:

4. Recuperar el ID de una carpeta

Esta petición devuelve el Id de una carpeta especificando su ruta, necesario para la parametrización del campo Id Carpeta Raiz, necesitamos ejecutar la petición llamada Recupera ID Carpeta previamente hemos tenido que crear o sustituir la variable RutaCarpeta, por la ruta relativa de la carpeta en el repositorio. Si abrimos dicha carpeta usando el