Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The MailUp RubyGem is currently being worked on, and will be released soon. This document will be updated with the gem is released.

Requirements

You will need to create a MailUp account in order to use the API. Once you have created your account, follow these instructions to activate the API for your account, so that you can get your API username and password. (Please note that the username/password required to access the API is different than the username/password used to access your MailUp account.)

Installation

Code Block
languageruby
(sudo) gem install mailup

Usage

The RubyGem provides wrappers for each of the following API classes:

...

The following examples show how to use each class, and additional code examples are available for each method in the API documentation.

HTTP GET/POST API

Interacting with the GET/POST API only requires your console_url, which is the base URL of your MailUp administrative interface (without the http://). For example, when you login to your MailUp administrative interface the URL might be something like http://abc123.s22.it/console/default.aspx. In that case, you would access the GET/POST API with the following:

...

Please refer to the documentation for each method of the GET/POST API for more code examples.

MailUp Import SOAP WebService

Make sure to activate the WSMailUpImport web service in order to use this service. Interacting with the Import web service requires your API username and password as well as your console_url:

...

The RubyGem outputs the XML response from the API, so that you can parse it as needed and rescue for error responses as needed. Please refer to the documentation for each method of the MailUp Import SOAP WebService for more error code explanations, sample responses, and code examples.

MailUp Send SOAP WebService

Make sure to activate the WSMailUpSend web service in order to use this service. Interacting with the Send web service requires only your API username and password:

...

The RubyGem outputs the XML response from the API, so that you can parse it as needed and rescue for error responses as needed. Please refer to the documentation for each method of the MailUp Send SOAP WebService for more error code explanations, sample responses, and code examples.

MailUp Manage SOAP WebService

Make sure to activate the WSMailUpManage web service in order to use this service. Interacting with the Send web service requires only your API username and password:

...

The RubyGem outputs the XML response from the API, so that you can parse it as needed and rescue for error responses as needed. Please refer to the documentation for each method of the MailUp Manage SOAP WebService for more error code explanations, sample responses, and code examples.

MailUp Report SOAP WebService

Make sure to activate the WSMailUpReport web service in order to use this service. Interacting with the Send web service requires only your API username and password:

...