Get Film with SWAPI - Star Wars API on New Status Bookmarked from Mastodon API

Pipedream makes it easy to connect APIs for SWAPI - Star Wars, Mastodon and 2,400+ other apps remarkably fast.

Trigger workflow on

New Status Bookmarked from the Mastodon API

Next, do this

Get Film with the SWAPI - Star Wars API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Mastodon trigger and SWAPI - Star Wars action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Status Bookmarked trigger
1. Connect your Mastodon account
2. Configure timer
Configure the Get Film action
1. Connect your SWAPI - Star Wars account
2. Select a film
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Status Bookmarked on Mastodon

Description:Emit new event when the specified status is bookmarked. [See the docs here](https://docs.joinmastodon.org/methods/bookmarks/)

Version:0.0.1

Key:mastodon-new-bookmark

View on GitHub

Mastodon Overview#

The Mastodon API enables you to interact with the Mastodon social network programmatically. Through Pipedream's integration, you can automate posting, monitor timelines, follow accounts, and more. Powerful workflows can be built around these capabilities, facilitating content distribution, social listening, and audience engagement without manual intervention.

Trigger Code#

import common from "../common/base.mjs";

export default {
  ...common,
  key: "mastodon-new-bookmark",
  name: "New Status Bookmarked",
  description: "Emit new event when the specified status is bookmarked. [See the docs here](https://docs.joinmastodon.org/methods/bookmarks/)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    setLastMaxId(value) {
      this.db.set("lastMaxId", value);
    },
    getLastMaxId() {
      return this.db.get("lastMaxId");
    },
    getUrl(str) {
      return str.substring(str.indexOf("<") + 1, str.lastIndexOf(">"));
    },
    getUrlParam(str, key) {
      const url = this.getUrl(str);
      const params = new URLSearchParams(url);
      return params.get(key);
    },
    generateMeta(bookmark) {
      return {
        id: bookmark.id,
        summary: `New Bookmark ${bookmark.id}`,
        ts: Date.parse(bookmark.created_at),
      };
    },
    emitEvent(resource) {
      const meta = this.generateMeta(resource);
      this.$emit(resource, meta);
    },
  },
  async run() {
    let hasNext;

    do {
      const {
        headers: { link },
        data: bookmarks,
      } = await this.mastodon.listBookmarkedStatuses({
        params: {
          max_id: this.getLastMaxId(),
          limit: 40,
        },
      });

      hasNext = link?.includes("next");

      if (hasNext) {
        const [
          str,
        ] = link.split(",");

        this.setLastMaxId(this.getUrlParam(str, "max_id"));
      }

      bookmarks.forEach(this.emitEvent);

    } while (hasNext);

    this.setLastMaxId(null);
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Mastodon	`mastodon`	`app`	This component uses the Mastodon app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

Mastodon uses API keys for authentication. When you connect your Mastodon account, Pipedream securely stores the keys so you can easily authenticate to Mastodon APIs in both code and no-code steps.

About Mastodon#

Mastodon is a decentralized social network made up of independent servers organized around specific themes, topics, or interests.

Action#

Get Film on SWAPI - Star Wars

Description:Get a film

Version:0.0.13

Key:swapi-get-film

View on GitHub

SWAPI - Star Wars Overview#

The SWAPI - Star Wars API is a treasure trove of structured data from the Star Wars universe. It's a go-to resource for fetching information about planets, spaceships, vehicles, people, films, and species from the iconic franchise. Using Pipedream, you can harness this data to create automations and workflows that trigger based on specific criteria from SWAPI. For instance, you could set up a workflow that notifies you when new data is added, enrich customer profiles with their favorite Star Wars characters, or even use it for trivia games by pulling random facts.

Action Code#

const swapi = require("../../swapi.app.js");
const axios = require("axios");

module.exports = {
  key: "swapi-get-film",
  name: "Get Film",
  version: "0.0.13",
  description: "Get a film",
  type: "action",
  props: {
    swapi,
    film: {
      propDefinition: [
        swapi,
        "film",
      ],
    },
  },
  async run() {
    return (await axios({
      url: `https://swapi.dev/api/films/${this.film}`,
    })).data;
  },
};