Los equipos innovadores de TI que utilizan la API de Smartsheet perciben beneficios en cuanto comienzan a usar la integración. La API es una herramienta eficaz para los desarrolladores que garantiza una combinación de gestión segura de los datos, automatización a través de webhooks y la capacidad de ajustar Smartsheet a escala en toda la empresa.
Por lo tanto, ¿desea crear una integración con la API de Smartsheet, pero no sabe con seguridad por dónde empezar? Siga estos cinco pasos que detallamos a continuación:
1. Explore los recursos para desarrolladores
El Portal para desarrolladores de Smartsheet es la “sede” de todos los recursos para desarrolladores. Allí encontrará documentación de la API, información sobre los SDK de Smartsheet, respuestas a sus preguntas específicas sobre la API de nuestra comunidad de usuarios y mucho más.
Si bien es tentador sumergirse directamente en la creación de la integración, dedicar tiempo a revisar estos recursos será beneficioso para el futuro.
Dónde encontrar documentación de la API
Luego de ver el video, visite nuestra página de documentación de la API. Ya sea que planee crear una integración que llame directamente a la API de Smartsheet o una que utilice un SDK de Smartsheet, los documentos de la API contienen mucha información útil. Para comenzar, conozca las siguientes secciones:
Descripción general: Contexto general para trabajar con la API de Smartsheet
Primeros pasos: Información necesaria para sentar las bases de la integración
Resolución de problemas: Información para crear un plan de resolución de problemas para momentos desafiantes
SDK de Smartsheet
Los kits de desarrollo de software (SDK) de Smartsheet proporcionan un medio para acceder a la API de la herramienta mediante el lenguaje de programación de su elección, sin la necesidad de escribir todo el código desde cero. Además de los métodos prediseñados, cada SDK también incluye lógica de reintentos (para errores de límite de velocidad) y sistemas de registro.
Cada SDK (C#, Java, Node, Python, Ruby) incluye documentación y una hoja de lectura/escritura de muestra disponible para su consulta.
2. Complete el “Registro de desarrolladores” (opcional)
Luego de dedicar tiempo a explorar los Recursos para desarrolladores de Smartsheet, debería estar listo para comenzar a crear su integración.
Crear una cuenta de desarrollador
Si planea crear una aplicación de terceros o si desea crear una cuenta de Smartsheet de espacio aislado que pueda usar para fines de desarrollo y pruebas (sin afectar los datos de su cuenta de Smartsheet de producción), deberá completar el proceso de Registro de desarrolladores.
3. Genere un token de acceso a la API
A continuación, para autenticar las solicitudes de API a través del Acceso directo a la API, necesitará un token de acceso que sea propiedad de la cuenta de Smartsheet a la que quiere acceder. Se pueden generar tokens de acceso a través de la interfaz de usuario de Smartsheet: solo tiene que iniciar sesión en su cuenta de Smartsheet y seguir estas instrucciones para generar un token.
Si crea una aplicación de terceros que implementará el flujo OAuth2 a fin de recuperar un token de acceso que se puede utilizar para acceder a los datos de Smartsheet en nombre de un usuario final, no necesitará generar un token de acceso de forma manual como se describe anteriormente. En cambio, consulte los documentos de la API para obtener información sobre el desarrollo de aplicaciones de terceros.
Si desarrolla una aplicación de terceros destinada a otros usuarios, deberá implementar un flujo OAuth2 para obtener un token de acceso. La generación automática (en lugar de manual) de un token de acceso garantiza que el usuario tenga su propio token para acceder a sus datos de Smartsheet. Recomendamos consultar la sección sobre el desarrollo de aplicaciones de terceros en la documentación de la API. A modo de referencia, tenemos un tutorial sobre cómo crear un flujo OAuth de Smartsheet en Node.js.
4. Comience a crear la integración
El proceso para crear la integración variará según decida usar un SDK o no. Ambos enfoques se detallan a continuación:
Si usa un SDK
Para usar un SDK como la base de la integración, instale el SDK de su elección siguiendo las instrucciones provistas para ese SDK particular. Luego, use la documentación de la API para obtener muestras de código y siga estos pasos:
En el panel de código de muestra a la derecha de la página, seleccione la pestaña correspondiente al lenguaje de su interés.
Lea el documento correspondiente al SDK y el ejemplo de lectura y escritura. Todos los enlaces están disponibles en el Portal para desarrolladores de Smartsheet.
Vaya a cualquier sección de la Referencia de la API para ver un ejemplo de código que indique cómo ejecutar la operación utilizando el SDK.
Si no usa un SDK
Si bien puede beneficiarse del uso de un SDK, no es obligatorio. Si decide no usar un SDK para crear una integración personalizada desde cero, consulte la Documentación de la API como recurso principal. Si tiene problemas para continuar, no dude en hacer preguntas en StackOverflow con la etiqueta smartsheet-api. Su pregunta podría ayudar a alguien en el futuro.
5. Solicite soporte a Smartsheet
Existe la posibilidad de que tenga un problema con la API o el SDK que no pueda resolver con nuestra guía de resolución de problemas de la API, o que no encuentre respuesta a sus preguntas en la Documentación de la API. Publique su problema o pregunta en StackOverflow, donde estamos preparados para brindar asistencia (junto con miles de desarrolladores de todo el mundo).
¿Tiene comentarios sobre la API o desea sugerir nuevas funciones de la API? Contáctenos a través de DevRel@smartsheet.com.
Descubra más recursos
Usar una nueva API por primera vez supone una instancia de aprendizaje, pero los recursos y procesos adecuados pueden marcar la diferencia.
Aproveche al máximo el Portal para desarrolladores de Smartsheet, donde encontrará los recursos y las guías que le permitirán familiarizarse rápidamente con la API de Smartsheet y sentir seguridad a la hora de implementar su solución.
Suscríbase al Boletín de TI de Smartsheet para recibir consejos, estrategias e ideas orientadas a ayudar a los profesionales de TI a aumentar el impacto en su negocio.
