Cómo conectarse a la API de Smartsheet con autenticación OAuth y obtener datos de Postman

Hoja inteligente (https://jp.smartsheet.com/welcome-customers-home) es una plataforma de aplicaciones sin código basada en datos similares a hojas de cálculo y es una herramienta con fortalezas en la gestión de proyectos y la automatización del flujo de trabajo.

Como existe una API, intenté usar Torima Postman (“Torima Postman” ahora es de conocimiento común en nuestra empresa).

Hice una hoja de muestra.

Preparándose para utilizar la API SmartSheet

Echemos un vistazo a la documentación API de Smartsheet.

Documentación API:https://smartsheet.redoc.ly/#section/Introducción

Método Raw Access Token y método OAuth 2.0

Hay dos métodos para acceder a la API de Smartsheet: el método del token de acceso sin formato y el método OAuth 2.0. Si desea probarlo primero, parece que el método Raw Access Token está bien, pero para uso real parece que se recomienda OAuth 2.0.

Para el token de acceso, abra su cuenta en la parte inferior izquierda de la pantalla,[個人用の設定]->[APIアクセス]->[新しいアクセストークンの生成]Se puede generar con .

En este artículo, explicaremos el acceso mediante OAuth 2.0 para uso real.

Obtener una cuenta de desarrollador

El acceso a la API con OAuth requiere obtener una cuenta de desarrollador y crear una aplicación de desarrollador.

Primero, vaya a su cuenta en la parte inferior izquierda de Smartsheet.[開発者ツール]Hacer clic.

Se abrirá la pantalla del desarrollador, así que[Register]Clic en el botón.

Se abrirá la pantalla de registro de cuenta de Developer Sandbox, así que registre su dirección de correo electrónico.[Register Developer Account]Clic en el botón.

Ahora debería recibir un correo electrónico informándole que su registro se ha completado.

Recibirás un correo electrónico como el siguiente en tu buzón. Haga clic en el enlace para activar.

Registre su nombre y dirección de correo electrónico como perfil de desarrollador.

Crear una aplicación de desarrollador

El acceso a la API con OAuth requiere la creación de una aplicación de desarrollador para el acceso a la API.[新しいアプリの作成]Clic en el botón.

Esta es la pantalla de configuración de la aplicación para desarrolladores. Regístrese como se muestra a continuación y haga clic en el botón Guardar.

nombre de la aplicación	(opcional)
Descripción de la aplicación	(opcional)
URL de la aplicación	URL de la aplicación que accede a la API	Esta vez accederé desde el Postman de escritorio, así que ingrese cualquier carácter.
Contacto/soporte de la aplicación	dirección de contacto	Esta vez los personajes apropiados.
URL de redireccionamiento de la aplicación	http://localhost:33333	Esta vez estoy accediendo desde el escritorio de Postman, por lo que es local.

Ahora puedes desarrollar una aplicación.[アプリクライアントid]y[アプリシークレット]fue obtenido. Guarde la clave ya que la usará para conectarse.

Ahora está listo para acceder a Smartsheet mediante la API.

Conéctese a la API de Smartsheet desde Postman

Ahora, cartero (https://www.postman.com/) para conectarse a Smartsheet a través de API.

Estoy usando Postman Desktop.

Abra la pestaña Autorización e ingrese los valores para la autenticación como se muestra a continuación.

Nombre del token	(opcional)
Tipo de subvención	Código de Autorización
URL de devolución de llamada	http://localhost:33333
URL de autenticación	https://app.smartsheet.com/b/authorize
URL del token de acceso	https://api.smartsheet.com/2.0/token
Identificación del cliente	ID de cliente de la aplicación obtenido anteriormente
Secreto del cliente	Secreto de aplicación obtenido anteriormente
Estado	LEER_HOJAS
Autenticación del cliente	Enviar credenciales de cliente en el cuerpo

Consulte la documentación para URL de autenticación y URL de token de acceso:https://smartsheet.redoc.ly/#section/OAuth-Walkthrough

　[State]es un privilegio de acceso API, por lo que enumeraremos los privilegios de acceso disponibles separándolos con comas de estos tipos de privilegios:https://smartsheet.redoc.ly/#section/OAuth-Walkthrough/Access-Scopes

Una vez que haya ingresado a la Autenticación, desplácese hacia abajo y[Get New Access Token]Haga clic en el botón naranja.

Se abrirá un navegador y, cuando inicie sesión en Smartsheet, se abrirá una pantalla que permitirá que la aplicación solicite acceso a Smartsheet, así que haga clic en el botón Permitir.

Esto esta bien.[Proceed]Presiona el botón.

Recibí la ficha, así que[Use Token]Pulsa el botón para habilitar el acceso con estos tokens en Postman.

Obtengamos una lista de hojas de Smartsheet usando Postman.

URI	https://api.smartsheet.com/2.0/sheets
Tipo de contenido	aplicación/json

Se ha devuelto una respuesta.

Pude recuperar el contenido de la hoja colocando la identificación de la hoja en el URI.

CData ofrece un conector que le permite acceder a la API de Smartsheet con SQL desde Excel normal, herramientas de BI, hojas de cálculo y herramientas ETL.Controladores CData para Smartsheet” está provisto. Si desea integrar Smartsheet con herramientas y aplicaciones existentes, analizar datos de Smartsheet, etc., pruebe el conector de integración de CData.