¡La beta pública de la API de Notion cayó! ¡Woot! Aquí está su guía. He sido usuario y fanático de Notion durante mucho tiempo, tanto para uso personal como profesional en equipo. Incluso patrocinaron algunos videos por aquí hace un tiempo que todavía son una gran representación de cómo uso Notion. Debido a que Notion está tan orientado al flujo de trabajo, es una aplicación perfecta para tener integraciones de API, lo que hace que esta versión parezca que tarda mucho en llegar.
🚧 Notion's API is now in public beta 🚧
It's the first step towards a brand new set of building blocks, so that you can tailor software to your own workflows.
We can't wait to see what you build! https://t.co/RZoHkEPiCa
— Notion (@NotionHQ) May 13, 2021
Esta es una API en toda regla, por lo que puede hacer las cosas que espera poder hacer, como cURL para los usuarios, el contenido de las páginas y manipular bases de datos. Tienen documentación detallada, barreras esperadas como límites de velocidad e incluso un SDK de JavaScript.
Esto cambia el juego en algunos servicios existentes. Por ejemplo, Super siempre fue una forma bastante elegante de hacer un sitio web impulsado por Notion, pero me pareció un poco arriesgado. ¿Qué pasa si a Notion no le gusta ese uso y lo corta de alguna manera? ¿O lanzó su propia herramienta similar? Meh, ya no es arriesgado. Las aplicaciones como Super pueden estar tranquilas sabiendo que hay una API real para esto, por lo que no tienen que hacer cualquier solución alternativa que estuvieran haciendo antes (¿raspando?) Y este tipo de uso probablemente se aliente, en todo caso.
También creo que fue muy inteligente por parte de Notion incluir integraciones predefinidas con otros servicios que la gente definitivamente querrá. Por ejemplo, puede conectar un formulario en TypeForm a una base de datos de Notion para que las nuevas entradas se coloquen allí automáticamente. Aún mejor, tienen integraciones Zapier y Automate, por lo que puede conectar casi cualquier integración de aplicación a aplicación que se le ocurra.
Estaba listo para comenzar a usar esta API de inmediato. En ShopTalk Show tenemos un formulario para hacer preguntas y enviamos esos envíos a Trello como una forma de colocarlos en algún lugar donde podamos hacer referencia a ellos y organizarlos. Pero realmente no usamos mucho Trello en estos días; pero hemos utilizado Notion para planificar desde hace mucho tiempo. Durante mucho tiempo he querido una forma de canalizar las preguntas de ese formulario directamente a Notion. Estaba listo para escribir un pequeño código para hacerlo, pero no tuve que hacerlo gracias a la integración de Zapier.
Así es como lo hice funcionar. El formulario ShopTalk existe en Wufoo:
Que incorporamos en nuestro sitio de WordPress:
Configuré un disparador Zapier para que se active cuando se envíe ese formulario:
Para asegurarme de que pueda ir a algún lugar de Notion, tuve que crear una nueva Integración en el lado de Notion:
¡Esta próxima parte es muy importante! Tienes que compartir explícitamente la base de datos con la integración, como si la integración fuera un usuario.
Una vez que haya hecho eso, puede ver la base de datos de Notion en el lado de Zapier y asignar los campos del formulario de Wufoo a los campos de la base de datos de Notion.
Ahora, cuando se completa el formulario, recibimos las nuevas preguntas de inmediato en Notion, ¡que es donde hacemos la planificación de nuestro programa de todos modos! ¡No más copiar y pegar basura de otros lugares!
Estaba muy feliz de haber hecho todo esto literalmente el primer día de tener esta API en versión beta pública. ¡Gran trabajo Notion!