Integrate the Linkish API with the Snowflake API

Setup the Linkish API trigger to run a workflow which integrates with the Snowflake API. Pipedream's integration platform allows you to integrate Linkish and Snowflake remarkably fast. Free for developers.

Overview of Linkish#

Linkish is a versatile API that enhances the way you handle web links. It allows you to organize, preview, and optimize web links with features such as URL shortening, web page metadata retrieval, and link previews with screenshots. With Pipedream, you can create powerful automations by connecting Linkish to other services to streamline content sharing, web research, and digital marketing workflows.

Connect Linkish#

module.exports = defineComponent({
  props: {
    linkish: {
      type: "app",
      app: "linkish",
    }
  },
  async run({steps, $}) {
    const axios = require('axios');
    let access_token = "";
    
    // Card details
    let type = "link", // either "link" or "text"
    		url = "https://www.youtube.com/watch?v=dQw4w9WgXcQ", // required if "type" is "link"
    		title = "", // card title, if empty it will be scraped from "url"
    		description = "", // card description, if empty it will be scraped from "url"
    		thumbnail = "", // preview image URL, if empty it will be scraped from "url"
    		parent = "", // collections[index].id recieved from get-collection API
    		tags = []; // an array of strings, items can also have comma separated strings
    
    // Get access token based on the linkish API key
    return await axios({
    	method  : "POST", 
    	url: "https://api.linkish.io/get-token",
    	data : JSON.stringify({
    		"api_key": this.linkish.$auth.api_key
    	}),
    	headers: {
    		"Content-Type": "application/json",
    		"Accept": "application/json",
    	}
    }).then(async (response) => {
    
    	// Get collections based on the access token
    	access_token = response.data.token;
    	return await axios({
    		method  : "GET",
    		url: "https://api.linkish.io/get-collections",
    		headers: {
    			"Authorization": `Bearer ${access_token}`,
    		}
    	})
    
    }).then((response) => {
    
    	// Return the data as the step export
    	return response.data;
    
    }).then(async (collections) => {
    
    	// Change parent collection ID here or keep it empty for adding links to root collection
    	parent = collections[0].id;
    
    	// Save link in linkish dashboard
    	return await axios({
    		method  : "POST",
    		url: "https://api.linkish.io/save-link",
    		data : JSON.stringify({
    			"type": type,
    			"url": url,
    			"title": title,
    			"desc": description,
    			"thumbnail": thumbnail,
    			"parent": parent,
    			"tags": tags,
    		}),
    		headers: {
    			"Authorization": `Bearer ${access_token}`,
    			"Content-Type": "application/json",
    			"Accept": "application/json",
    		}
    	})
    
    }).then((response) => {
    
    	// Return the data as the step export
    	return response.data
    
    })
  },
})

Overview of Snowflake#

Snowflake offers a cloud database and related tools to help developers create robust, secure, and scalable data warehouses. See Snowflake's Key Concepts & Architecture.

Getting Started

1. Create a user, role and warehouse in Snowflake

Snowflake recommends you create a new user, role, and warehouse when you integrate a third-party tool like Pipedream. This way, you can control permissions via the user / role, and separate Pipedream compute and costs with the warehouse. You can do this directly in the Snowflake UI.

We recommend you create a read-only account if you only need to query Snowflake. If you need to insert data into Snowflake, add permissions on the appropriate objects after you create your user.

2. Enter those details in Pipedream

Visit https://pipedream.com/accounts. Click the button to Connect an App. Enter the required Snowflake account data.

You'll only need to connect your account once in Pipedream. You can connect this account to multiple workflows to run queries against Snowflake, insert data, and more.

3. Build your first workflow

Visit https://pipedream.com/new to build your first workflow. Pipedream workflows let you connect Snowflake with 1,000+ other apps. You can trigger workflows on Snowflake queries, sending results to Slack, Google Sheets, or any app that exposes an API. Or you can accept data from another app, transform it with Python, Node.js, Go or Bash code, and insert it into Snowflake.

Learn more at Pipedream University.

Connect Snowflake#

import { promisify } from 'util'
import snowflake from 'snowflake-sdk'

export default defineComponent({
  props: {
    snowflake: {
      type: "app",
      app: "snowflake",
    }
  },
  async run({steps, $}) {
    const connection = snowflake.createConnection({
      ...this.snowflake.$auth,
      application: "PIPEDREAM_PIPEDREAM",
    })
    const connectAsync = promisify(connection.connect)
    await connectAsync()
    
    async function connExecuteAsync(options) {
      return new Promise((resolve, reject) => {
        connection.execute({
          ...options,
          complete: function(err, stmt, rows) {
            if (err) {
              reject(err)
            } else {
              resolve({stmt, rows})
            }
          }
        })
      })
    }
    
    // See https://docs.snowflake.com/en/user-guide/nodejs-driver-use.html#executing-statements
    const { rows } = await connExecuteAsync({
      sqlText: `SELECT CURRENT_TIMESTAMP()`,
    })
    return rows
  },
})

Linkish