The Keap Ruby Gem

### XML-RPC API (Legacy)

The XML-RPC API is the original Infusionsoft API. Use this for legacy integrations or when you need access to older Infusionsoft features.

#### Setup for XML-RPC

```ruby
# Added to your config\initializers file
Infusionsoft.configure do |config|
  config.api_url = 'YOUR_INFUSIONSOFT_URL' # example infused.infusionsoft.com DO NOT INCLUDE https://
  config.api_key = 'YOUR_INFUSIONSOFT_SERVICE_KEY' # Or Oauth Access Token or Legacy Key.
  config.api_logger = Logger.new("#{Rails.root}/log/infusionsoft_api.log") # optional logger file
  config.use_oauth = true # false if using legacy api key
end

# Get a users first and last name using the DataService
Infusionsoft.data_load('Contact', contact_id, [:FirstName, :LastName])

# Get a list of custom fields
Infusionsoft.data_find_by_field('DataFormField', 100, 0, 'FormId', -1, ['Name'])
# Note, when updating custom fields they are case sensisitve and need to be prefaced with a '_'

# Update a contact with specific field values
Infusionsoft.contact_update(contact_id, { :FirstName => 'first_name', :Email => 'test@test.com' })

# Add a new Contact
Infusionsoft.contact_add({:FirstName => 'first_name', :LastName => 'last_name', :Email => 'test@test.com'})

# Create a blank Invoice
invoice_id = Infusionsoft.invoice_create_blank_order(contact_id, description, Date.today, lead_affiliate_id, sale_affiliate_id)

# Then add item to invoice
Infusionsoft.invoice_add_order_item(invoice_id, product_id, product_type, amount, quantity, description_here, notes)

# Then charge the invoice
Infusionsoft.invoice_charge_invoice(invoice_id, notes, credit_card_id, merchange_id, bypass_commissions)

# Generate the authorization URL for user consent
auth_url = Infusionsoft::Rest::Token.auth_url(
  client_id: 'YOUR_CLIENT_ID',
  redirect_uri: 'YOUR_REDIRECT_URI'
)

# Redirect user to this URL to authorize your application
puts auth_url
# => "https://signin.infusionsoft.com/app/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=full&response_type=code"

# Exchange the authorization code for an access token
token = Infusionsoft::Rest::Token.get_token(
  client_id: 'YOUR_CLIENT_ID',
  client_secret: 'YOUR_CLIENT_SECRET',
  redirect_uri: 'YOUR_REDIRECT_URI',
  code: 'AUTHORIZATION_CODE_FROM_STEP_2'
)

# The token object contains access_token, refresh_token, and expiration
puts token.access_token
puts token.refresh_token
puts token.expiration

# Refresh the access token using the refresh token
new_token = Infusionsoft::Rest::Token.refresh(
  client_id: 'YOUR_CLIENT_ID',
  client_secret: 'YOUR_CLIENT_SECRET',
  refresh_token: token.refresh_token
)

# Check if token is still valid
if token.valid?
  puts "Token is still valid"
else
  puts "Token has expired, need to refresh"
end

# Example: GET request (v1)
response = Infusionsoft.get('/contacts', token, query: { email: 'test@example.com' }, version: 'v1')
puts response

# Example: POST request (v2)
response = Infusionsoft.post('/paymentMethodConfigs', token, payload: { contact_id: 1234 }, version: 'v2')
puts response

# Example: Handling errors
begin
  Infusionsoft.post('/paymentMethodConfigs', token, payload: { contact_id: 1234 }, version: 'v2')
rescue Infusionsoft::InvalidParameterError => e
  puts "Invalid parameter: #{e.message}"
rescue Infusionsoft::NoAccessError => e
  puts "No access: #{e.message}"
rescue Infusionsoft::UnexpectedError => e
  puts "Unexpected error: #{e.message}"
end