What’s supported

Supported actions

This connector supports:
  • Proxy Actions, using the base URL https://{{.workspace}}, where workspace is your Discourse-hosted domain.

Example integration

To define an integration for Discourse, create a manifest file that looks like this:
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: discourse-integration
    displayName: My Discourse Integration
    provider: discourse
    proxy:
      enabled: true

Using the connector

This connector uses API Key auth along with an API Username, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.)
The API Username is currently set to system for everyone. Please use system as the username when configuring your integration. For more information, see the Discourse API documentation.
To start integrating with Discourse:
  • Create a manifest file like the example above.
  • Deploy it using the amp CLI.
  • Embed the InstallIntegration UI component. The UI component will prompt the customer for an API key.
  • Start making Proxy Calls, and Ampersand will automatically attach the API key and API Username supplied by the customer. Please note that this connector’s base URL is https://{{.workspace}}.

Creating an API key for Discourse

Click here for more information about generating an API key for Discourse.