¿Cómo podemos ayudar?

¿Tiene monday.com una API?

 

¡Claro que sí! Nuestra API se basa en GraphQL y te dará muchísima flexibilidad para acceder y modificar información en tu cuenta de monday.com.

 

Sugerencia: Para obtener información más detallada sobre todo lo relacionado con la API, asegúrate de consultar nuestra documentación de la API.

 

¿Por qué GraphQL?

Nuestros usuarios usan monday.com para gestionar todo tipo de información y queríamos crear una API que fuera tan flexible como nuestra plataforma. Por eso creamos una API capaz de manejar consultas expresivas para obtener exactamente la información que necesitas, cuando la necesitas. Si quieres saber más sobre GraphQL como lenguaje de consulta, visita graphql.org. 😄 

 

Documentación y pruebas

Para facilitar el uso de nuestra API, hemos escrito documentación que explica las consultas y mutaciones que puedes realizar con tus datos. También puedes probar tus consultas en nuestro explorador de GraphQL

 

Autenticación con tu token de API

Cualquier solicitud que se haga a la API debe estar acompañada por un token de API, para que podamos saber que eres tú. 😊

 

API para usuarios administradores

Cada administrador de cuenta tiene su propio token de API, ¡asegúrate de guardarlo en un lugar seguro! Para generar tu token de API, haz lo siguiente: 

  1. Inicia sesión en tu cuenta de monday.com.
  2. Haz clic en tu avatar en la esquina superior derecha.
  3. Selecciona "Administración"
  4. Haz clic en "Conexiones" en el lado izquierdo de la página de administración. 
  5. Selecciona "API" en el menú superior. 
  6. Haz clic en el botón "Copiar" a la derecha del token API personal. Esto es lo que deberías ver:

Admin API Token.png

 

API para usuarios que no son administradores

Si no eres administrador de tu cuenta en monday.com, puedes obtener tus Tokens de API a través de la sección de desarrolladores, siguiendo estos pasos: 

  1. Inicia sesión en tu cuenta de monday.com.
  2. Haz clic en tu avatar en la esquina superior derecha.
  3. Selecciona "desarrolladores".
  4. Haz clic en "Desarrollador" y luego en "Mis tokens de acceso" en la parte superior. 
  5. Al seleccionar "Mostrar" junto al token de la API, también podrás copiarlo. 

Puedes usar este token de API para autenticar todas tus solicitudes a nuestra API y en nuestro entorno de pruebas. El token se puede regenerar en cualquier momento, pero ten en cuenta que esto hará que el antiguo caduque. 

 

Tokens de API generados a través de OAuth

También puedes generar un token para aplicaciones específicas mediante el flujo de autorización de OAuth. Los permisos de estos tokens están limitados según los alcances de autorización de la aplicación a la que están vinculados. Para obtener más información, consulta nuestra documentación de OAuth.

 

Permisos de token de API

El token de API de cada usuario se centra en los permisos de ese usuario. 

Por ejemplo, si el usuario tiene acceso de solo lectura a un tablero determinado, el token de API no podrá actualizar ninguna información en ese tablero. 

Del mismo modo, si un usuario no tiene acceso a un tablero privado, ninguna aplicación que use el token de API tendrá acceso a ese tablero. 

Nota: Actualmente no admitimos tokens de API de "superusuarios" que tienen acceso de lectura y escritura a todos los tableros de una cuenta. 

 

Cómo acceder a nuestra API GraphQL

Sabemos que a nuestros usuarios les gusta probar las funciones antes de implementarlas, ¡así que incluimos un editor de consultas en nuestra plataforma! Puedes usarlo para probar consultas y mutaciones antes de implementarlas en tu aplicación. Para usar el explorador de API, accede a este enlace.

Una vez que hayas abierto la página del explorador, introduce tu token de API en este campo: 

image_1.png

Después de ingresar tu token, entrarás en nuestro entorno de prueba. En el panel izquierdo del explorador debes introducir tu consulta o mutación y, cuando presiones "Reproducir", arriba a la izquierda, el panel derecho te mostrará tus resultados. 

Frame_10.png

También puedes hacer clic en el botón "Documentos" arriba a la derecha para acceder a nuestra documentación directamente desde el explorador. Para acceder a nuestra documentación por fuera del explorador, ¡consulta este enlace!

 

Cómo enviar solicitudes

¿Probaste tus consultas y estás listo para enviarlas directamente desde tu aplicación? ¡Estás en el lugar indicado! 😊

Todas las solicitudes a nuestro servidor deben ser solicitudes POST enviadas a api.monday.com/v2. 

Asegúrate de usar el tipo de contenido aplicación/json y pasa tu clave de API como un parámetro de "Autorización" en los encabezados:

{
"Content-Type" : "application/json",
"Authorization" : "mySuperSecretAPIKey"
}

El cuerpo de la solicitud es donde se pasan tus consultas y variables. Deberías tener algo así:

{ 
"query" : "...",
"variables" : {"myVariable" : "foo", "yourVariable" : "bar"}
}  

 

Colección de Postman

Hemos recopilado ejemplos de las solicitudes de API más comunes en una colección de Postman. Puedes usarla para probar solicitudes de muestra con nuestra API y generar fragmentos de código para copiar en tu aplicación. Echa un vistazo a los ejemplos para que puedas probar tus propias solicitudes.

¿Por qué usar la API?

¿No estás seguro de si necesitas usar la API o no? La API permite que las aplicaciones personalizadas accedan al sistema operativo de trabajo de monday, para que puedas conectar tus propios scripts, integraciones y herramientas a tus flujos de trabajo. Si esto suena como algo que te interesa, entonces la API es para ti.

Puedes utilizar la API de muchas maneras para potenciar tus flujos de trabajo. Aquí puedes ver algunos ejemplos:

  • Conexión a integraciones de datos de terceros
  • Configuración de herramientas de integración sin código como Zapier para crear flujos de datos personalizados
  • Importación y exportación de datos en lotes
  • Usar la API como una capa de datos para que las apps de monday personalizadas se conecten a monday

Cómo llegar más lejos

La plataforma monday también contiene herramientas para crear apps integradas dentro de tus flujos de trabajo, como vistas de tableros de apps, integraciones y más.

Si necesitas aún más opciones para mejorar tus flujos de trabajo, puedes utilizar la estructura de las apps de monday para crear apps personalizadas para necesidades específicas dentro de tu espacio de trabajo. Obtén más información en nuestra documentación de la estructura de las apps y profundiza en nuestros ejemplos.

Límite de acciones

Los límites de API se basan en el nivel de complejidad, que está limitado a 100.000.00 por minuto por cuenta. Puedes obtener más información al respecto aquí.

 

¡Feliz programación!

Ahora que tienes una comprensión básica sobre cómo enviar solicitudes a nuestra API, sigue adelante y consulta nuestra documentación de API. ¡También puedes jugar con nuestro entorno de pruebas!

Y por último, consulta nuestros tutoriales de inicio rápido en diferentes lenguajes de programación:

 

 

 


 

Si tienes preguntas, comunícate con nuestro equipo aquí. Estamos disponibles las 24 horas, los 7 días de la semana, y será un gusto ayudarte.