Linkish is a versatile API that enables developers to create a wide variety of applications. Some examples of what can be built using Linkish include:
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
})
},
})
Linkish uses API keys for authentication. When you connect your Linkish account, Pipedream securely stores the keys so you can easily authenticate to Linkish APIs in both code and no-code steps.
Get your API key (or generate a new one) from https://linkish.io/settings.