DOCUMENTATION.md

Getting started

The MessageMedia Messages API provides a number of endpoints for building powerful two-way messaging applications.

How to Build

• In order to successfully build and run your SDK files, you are required to have the following setup in your system:
  • Go (Visit https://golang.org/doc/install for more details on how to install Go)
  • Java VM Version 8 or later
  • Eclipse 4.6 (Neon) or later (http://www.eclipse.org/neon/)
  • GoClipse setup within above installed Eclipse (Follow the instructions at this link to setup GoClipse)
• Ensure that GOPATH environment variable is set in the system variables. If not, set it to your workspace directory where you will be adding your Go projects.
• The generated code uses unirest-go http library. Therefore, you will need internet access to resolve this dependency. If Go is properly installed and configured, run the following command to pull the dependency:

go get github.com/apimatic/unirest-go

This will install unirest-go in the GOPATH you specified in the system variables.

Now follow the steps mentioned below to build your SDK:

1. Open eclipse in the Go language perspective and click on the Import option in File menu.

2. Select General -> Existing Projects into Workspace option from the tree list.

3. In Select root directory, provide path to the unzipped archive for the generated code. Once the path is set and the Project becomes visible under Projects click Finish

4. The Go library will be imported and its files will be visible in the Project Explorer

How to Use

The following section explains how to use the MessageMediaMessages library in a new project.

1. Add a new Test Project

Create a new project in Eclipse by File -> New -> Go Project

Name the Project as Test and click Finish

Create a new directory in the src directory of this project

Name it test.com

Now create a new file inside src/test.com

Name it testsdk.go

In this Go file, you can start adding code to initialize the client library. Sample code to initialize the client library and using its methods is given in the subsequent sections.

2. Configure the Test Project

You need to import your generated library in this project in order to make use of its functions. In order to import the library, you can add its path in the GOPATH for this project. Follow the below steps:

Right click on the project name and click on Properties

Choose Go Compiler from the side menu. Check Use project specific settings and uncheck Use same value as the GOPATH environment variable.. By default, the GOPATH value from the environment variables will be visible in Eclipse GOPATH. Do not remove this as this points to the unirest dependency.

Append the library path to this GOPATH

Once the path is appended, click on OK

3. Build the Test Project

Right click on the project name and click on Build Project

4. Run the Test Project

If the build is successful, right click on your Go file and click on Run As -> Go Application

Initialization

Authentication

In order to setup authentication of the API client, you need the following information.

Parameter	Description
basicAuthUserName	The username to use with basic authentication
basicAuthPassword	The password to use with basic authentication

To configure these for your generated code, open the file "Configuration.go" and edit it's contents.