UseParagon

The UseParagon Ruby Gem simplifies the interaction with Paragon's service through RESTful API calls, enabling seamless integration of native features into your Ruby applications. With this gem, engineering teams can effortlessly incorporate Paragon's API to accelerate the development of native integrations.

Add the gem to your application's Gemfile by executing:

$ bundle add use_paragon

or manually add it to the Gemfile:

gem "use_paragon"

Then run:

bundle install

If Bundler is not used to manage dependencies, install the gem with:

$ gem install use_paragon

To use the UseParagon gem, you need to configure it with your private key and project ID. Here's an example on how to do it:

Provide your private key and project ID:

UseParagon.configure do |config|
  config.private_key = YOUR_PRIVATE_KEY
  config.project_id = YOUR_PROJECT_ID
  # Additional configurations available and defaults.
  # config.base_url = "https://zeus.useparagon.com"
  # config.logger = Logger.new(STDOUT)
  # config.logger_enabled = true
end

Paragon Documentation

Call disable Workflow to turn off a workflow for a user by ID.

UseParagon::Workflow.new(user_id).disable("workflow_id")

Paragon Documentation

Get the name, brandColor, and icon, for any of your active integration providers.

UseParagon::Integration.new(user_id).metadata

Paragon Documentation

Retrieve the currently authenticated user and their connected integration state.

UseParagon::User.new(user_id).get

Paragon Documentation

App Events can be sent from your application using the Paragon REST API.

UseParagon::Workflow.new(user_id).event(event_name, payload = {})

Paragon Documentation

Call proxy_request to send an API request to a third-party integration on behalf of one of your users

This endpoint accepts any HTTP verb you want to use with the API: post, get, put, patch or delete.

UseParagon::Integration.new(user_id).proxy_request(request_method, integration_type, integration_path, payload = {})

Paragon Documentation

Associate the authenticated user with metadata from your application. This metadata can be accessed with "Get User"

UseParagon::User.new(user_id).metadata=({email: "example@example.com"})

Paragon Documentation

Disconnect an integration for the authenticated user

UseParagon::Integration.new(user_id).uninstall(integration_id)

Paragon Documentation

Trigger a Paragon workflow that sends a custom response back to your app. Note: The workflow must be enabled and use a Request-type trigger.

UseParagon::Workflow.new(user_id).request(workflow_id, payload = {})

Paragon Documentation

Returns a list of the integrations enabled for the Paragon project by the ID in the URL.

UseParagon::Integration.new(user_id).list

Paragon Documentation

Returns a list of the user's Connect credentials (i.e., the accounts connected and authorized by the end user).

UseParagon::User.new(user_id).credentials

Bug reports and pull requests are welcome on GitHub at https://github.com/candanedo/use_paragon. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the UseParagon project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.