Site icon FSIBLOG

How to Connect with MailChimp API in Ruby Code

Shaheen Ullah
How to Connect with MailChimp API in Ruby Code

How to Connect with MailChimp API in Ruby Code

I’ve been working on a simple newsletter signup feature for my Ruby on Rails application, and I hit a snag that I believe many developers can relate to. Today, I want to share my journey diagnosing and resolving an error with the MailChimp API. I’ll walk you through my original code, explain the error I encountered, and finally present a revised version with additional functionality for practice. Let’s dive in!

Error Code

In my MailChimp controller, I wrote the following code to handle newsletter signups capturing a user’s name and email address. When the form data was submitted, I received an error response.

MailchimpController < ApplicationController

  require "net/http"
  require "uri"

  def subscribe  
    if request.post?
      mailchimp = {}
      mailchimp['apikey']  = 'f72328d1de9cc76092casdfsd425e467b6641-us2'
      mailchimp['id']  = '8037342dd1874'
      mailchimp['email_address']  = "email@gmail.com"
      mailchimp['merge_vars[FNAME]']  = "FirstName"
      mailchimp['output']  = 'json'

      uri = URI.parse("http://us2.api.mailchimp.com/1.3/?method=listSubscribe")
      response = Net::HTTP.post_form(uri, mailchimp)    
      mailchimp = ActiveSupport::JSON.decode(response.body)

      if mailchimp['error']
        render :text => mailchimp['error'] + "code:" + mailchimp['code'].to_s  
      elsif mailchimp == 'true'
        render :text => 'ok' 
      else
        render :text => 'error'
      end
    end
  end    

end

Decoding the Error Message

When I executed this code, I was greeted with the following error:

"Method is not exported by this server -90"

What does this really mean?

  1. API Endpoint/Method Issue:
    The error tells me that the API method I’m trying to call listSubscribe is not available from the MailChimp server I’m interacting with. This typically hints at one or more underlying issues.
  2. Deprecated API Version:
    The code is using MailChimp API version 1.3. As I later learned, this version is outdated. MailChimp has since upgraded to newer versions (like v3.0), which use updated endpoints and different methods.
  3. Insecure Connection and Endpoint Changes:
    I was using an http:// URL instead of https://. MailChimp now requires secure communication, and the endpoint URL might be different from what was originally used.
  4. Parameter Mismatch:
    Sometimes the format or naming of parameters (such as merge variables) changes between versions, leading to errors when the server receives unexpected input.

Steps I Took to Resolve the Issue

Here’s what I did after encountering the error:

The Improved Code

Below is my revamped MailChimp controller with enhanced error handling, dynamic input, and additional unsubscribe functionality:

 MailchimpController < ApplicationController

  require "net/http"
  require "uri"
  require "json"

  # Subscribe action for newsletter signup
  def subscribe  
    if request.post?
      # Retrieve form data (ensure your form posts these parameters)
      email      = params[:email] || "email@gmail.com"
      first_name = params[:first_name] || "FirstName"

      mailchimp_params = {
        'apikey'            => 'f72328d1de9cc76092casdfsd425e467b6641-us2',
        'id'                => '8037342dd1874',
        'email_address'     => email,
        'merge_vars[FNAME]' => first_name,
        'output'            => 'json'
      }

      # Use HTTPS endpoint for added security
      uri = URI.parse("https://us2.api.mailchimp.com/1.3/?method=listSubscribe")
      
      begin
        response = Net::HTTP.post_form(uri, mailchimp_params)
        result = JSON.parse(response.body)

        if result['error']
          render :text => "Error: #{result['error']} (code: #{result['code']})"
        elsif result == true || result == 'true'
          render :text => 'Subscription successful!'
        else
          render :text => 'An unexpected error occurred.'
        end
      rescue StandardError => e
        logger.error "Mailchimp Subscribe Error: #{e.message}"
        render :text => "An error occurred: #{e.message}"
      end
    end
  end

  # Additional practice functionality: Simulated Unsubscribe action
  def unsubscribe
    if request.post?
      email = params[:email] || "email@gmail.com"

      mailchimp_params = {
        'apikey'        => 'f72328d1de9cc76092casdfsd425e467b6641-us2',
        'id'            => '8037342dd1874',
        'email_address' => email,
        'output'        => 'json'
      }

      uri = URI.parse("https://us2.api.mailchimp.com/1.3/?method=listUnsubscribe")
      
      begin
        response = Net::HTTP.post_form(uri, mailchimp_params)
        result = JSON.parse(response.body)

        if result['error']
          render :text => "Error: #{result['error']} (code: #{result['code']})"
        elsif result == true || result == 'true'
          render :text => 'Unsubscription successful!'
        else
          render :text => 'An unexpected error occurred.'
        end
      rescue StandardError => e
        logger.error "Mailchimp Unsubscribe Error: #{e.message}"
        render :text => "An error occurred: #{e.message}"
      end
    end
  end
end

Key Enhancements and Benefits

Final Thoughts

I learned that even a seemingly simple newsletter signup can present a range of challenges from outdated API versions and insecure endpoints to parameter mismatches and inadequate error handling. The error "Method is not exported by this server -90" was a clear signal that changes were needed. By updating the connection protocol, embracing dynamic user input, and beefing up error management, I not only solved the problem but also set the stage for further enhancements.

Exit mobile version