Este artículo presenta los pasos para generar y descargar órdenes de trabajo con la API de Scantrust. El token UAT debe tener acceso a los siguientes permisos:
scans_download
Importante:
Para acceder a la API REST de Scantrust, puede usar una plataforma de API como Postman. Esta es la plataforma de API más popular del mundo, con más de 17 millones de usuarios y 500 000 organizaciones en todo el mundo. La herramienta ofrece un entorno flexible y colaborativo que le permite diseñar, desarrollar, documentar y probar sus API con mayor rapidez.
Puedes probar la aplicación web o descargar e instalar esta aplicación desde este enlace: https://www.postman.com/downloads/ En cualquier caso, deberá registrarse con una dirección de correo electrónico válida.
Nota: En el contexto de Scantrust, Postman solo debe usarse con fines de prueba. No debe utilizarse en escenarios reales ni en implementaciones de proyectos.
Pasos para configurar Postman
1. Abra Postman. En la página de inicio, debería ver lo siguiente:
2. Luego, haga clic en la pestaña denominada: “Espacios de trabajo”, en la esquina superior izquierda:
3. Luego, haz clic en la opción “Mi espacio de trabajo”:
4. Una vez que esté en su espacio de trabajo, haga clic en el signo “+” de la siguiente manera:
5. Después de eso, aparecerá una nueva pestaña con una solicitud de API preconfigurada: GET:
6. Ahora es importante configurar la autorización de la API. Para ello, haga clic en la pestaña "Autorización":
7. A continuación, haga clic en la sección "Tipo" y seleccione la opción "Clave API", como se indica a continuación:
8. Ahora, escriba la palabra "Autorización" en el campo clave, luego copie su token UAT del portal ST y péguelo en el campo "Valor", incluyendo los caracteres UAT.UAT [tu token],dejando una barra espaciadora entre la cadena UAT y el token:
9. Luego, vaya a la pestaña “Cuerpo”, seleccione “sin procesar” y seleccione “JSON”:
Pasos para descargar datos escaneados
Para descargar sus datos de escaneo, necesita:
- Encuentra el ID de la campaña
- Establezca el período de tiempo para filtrar los escaneos, según un rango de tiempo.
Cómo encontrar el ID de tu campaña:
1. Inicie sesión en el portal y haga clic en CAMPAÑAS en el menú de hamburguesas de la izquierda.
2. En la campaña cuyos datos desea descargar, haga clic en el ícono TABLERO:
3. Cuando se abra el panel, la URL en el navegador mostrará:
https://portal.scantrust.com/#/dashboard?tabIndex=0&campañaId=126&página=1
El ID de la campaña está en negrita.
4. A continuación, debe filtrar la información que desea descargar. Todos los filtros del panel también se pueden usar para filtrar los análisis descargados. Por ejemplo, si desea filtrar y descargar todos los análisis de campaña 195,que fueron marcados fuera del mercado y que tienen mercado previsto establecido en "China" (Zh). Para lograr esto, debe configurar una solicitud GET con la siguiente URL:
5. Entonces deberías obtener una respuesta de 200 OK:
Comentarios