Ruby

gem 'bundleup-sdk'

bundle install

gem install bundleup-sdk

require 'bundleup-sdk'

# Initialize the client with your API key
client = Bundleup::Client.new(ENV['BUNDLEUP_API_KEY'])

# List all connections
connections = client.connections.list
puts connections

# Initialize with API key
client = Bundleup::Client.new('your_api_key_here')

# Or use environment variable (recommended)
client = Bundleup::Client.new(ENV['BUNDLEUP_API_KEY'])

# List all connections
connections = client.connections.list

# List with pagination
connections = client.connections.list(limit: 10, page: 1)

# Retrieve a specific connection
connection = client.connections.retrieve('conn_123')

# Delete a connection
client.connections.delete('conn_123')

# List all integrations
integrations = client.integrations.list

# Retrieve a specific integration
integration = client.integrations.retrieve('int_123')

# List all webhooks
webhooks = client.webhooks.list

# Create a webhook
webhook = client.webhooks.create({
  url: 'https://example.com/webhook',
  events: ['connection.created', 'connection.deleted']
})

# Retrieve a webhook
webhook = client.webhooks.retrieve('webhook_123')

# Update a webhook
updated = client.webhooks.update('webhook_123', {
  url: 'https://example.com/new-webhook'
})

# Delete a webhook
client.webhooks.delete('webhook_123')

# Initialize proxy for a connection
proxy = client.proxy('conn_123')

# Make GET request
users = proxy.get('/api/users')

# Make POST request
new_user = proxy.post('/api/users', {
  name: 'John Doe',
  email: 'john@example.com'
})

# Make PUT request
updated_user = proxy.put('/api/users/123', {
  name: 'Jane Doe'
})

# Make PATCH request
patched_user = proxy.patch('/api/users/123', {
  email: 'jane@example.com'
})

# Make DELETE request
proxy.delete('/api/users/123')

# Get unified API instances for a connection
unify = client.unify('conn_123')

# List channels
channels = unify[:chat].channels(limit: 100)

# List channels with pagination
channels = unify[:chat].channels(limit: 50, cursor: 'next_page_token')

# Include raw response from the integration
channels = unify[:chat].channels(limit: 100, include_raw: true)

unify = client.unify('conn_123')

# List repositories
repos = unify[:git].repos(limit: 50)

# List pull requests for a repository
pulls = unify[:git].pulls('owner/repo', limit: 20)

# List tags for a repository
tags = unify[:git].tags('owner/repo')

# List releases for a repository
releases = unify[:git].releases('owner/repo', limit: 10)

# Include raw response
repos = unify[:git].repos(include_raw: true)

unify = client.unify('conn_123')

# List issues
issues = unify[:pm].issues(limit: 100)

# List with pagination
issues = unify[:pm].issues(limit: 50, cursor: 'next_page_token')

# Include raw response
issues = unify[:pm].issues(include_raw: true)

begin
  client = Bundleup::Client.new('invalid_key')
  connections = client.connections.list
rescue Bundleup::AuthenticationError => e
  puts "Authentication failed: #{e.message}"
rescue Bundleup::InvalidRequestError => e
  puts "Invalid request: #{e.message}"
rescue Bundleup::APIError => e
  puts "API error: #{e.message}"
rescue Bundleup::Error => e
  puts "General error: #{e.message}"
end

# The SDK uses Faraday under the hood with automatic retries
# Retry logic is configured with:
# - Max retries: 3
# - Initial interval: 0.5 seconds
# - Backoff factor: 2

# Using limit and page
connections = client.connections.list(limit: 10, page: 1)

# Using cursor-based pagination (for Unify API)
channels = unify[:chat].channels(limit: 50, cursor: 'next_page_token')