Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API, specifically supporting various resources and operations including authentication. The 'Register Application' operation under the 'Authentication' resource allows users to register a new application with a Mastodon instance. This is useful for developers who want to create an app that integrates with Mastodon, enabling OAuth2 authentication and API access. For example, a developer can register their app by providing the Mastodon instance URL, client name, redirect URIs, scopes, and optionally a website URL.

Use Case Examples

  1. Register a new Mastodon application by specifying the instance URL, client name, redirect URIs, and scopes to obtain client credentials for OAuth2 authentication.
  2. Use the node to automate the registration of multiple applications across different Mastodon instances.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to, required to specify which Mastodon server the app will register with.
Client Name Name of your application, used to identify the app during registration.
Redirect URIs Where the user should be redirected after authorization, essential for OAuth2 flow.
Scopes Space-separated list of scopes defining the permissions the app requests.
Website URL of your website, optional field to provide additional app information.

Output

JSON

  • json
    • client_id - The client ID assigned to the registered application.
    • client_secret - The client secret assigned to the registered application.
    • redirect_uri - The redirect URI registered for the application.
    • scopes - The scopes granted to the application.
    • website - The website URL provided during registration.

Dependencies

  • Mastodon API

Troubleshooting

  • Ensure the Mastodon URL is correct and accessible; incorrect URLs will cause connection failures.
  • Verify that all required fields (Client Name, Redirect URIs, Scopes) are provided; missing required fields will cause registration errors.
  • Check network connectivity and API rate limits if requests fail or time out.
  • If the operation is not implemented or unknown resource is specified, the node throws an error indicating the issue.

Links

Discussion