Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

What is the Mapp Engage API?

An API is used  to share information without the need for human intervention.
The Mapp Engage API makes it possible for you to connect any program to your marketing platform.

For an overview of the SOAP solution, see SOAP API. For an overview of the REST solution, see REST API.

Authorization & Permissions

Both SOAP and REST API use HTTP basic authentication method
that does not require cookies or session tokens.

For this reason, there are no explicit login and logout methods.
Instead, the authorization header must be included in each API request.

The example header for 'test@test.com' user and 'test' password is following

Authorization: Basic dGVzdEB0ZXN0LmNvbTp0ZXN0

You should use the "API user" or "Hybrid User" user type for authentication.

Host header

Some systems might require host-header

e.g :

Host: staging11.shortest-route.com

Versioning

Contact Mapp Technical Support to confirm if you have the latest version.
At the moment this is v19.

Tools

SoapUI is an open-source web service testing tool

Download and install soapui

To setup REST project

To setup SOAP project

To setup Control XML project

To setup SOAP 1.0 (deprecated)


Start testing

  • Import project into SOAPUI

  • Add user and password as on the picture

Other tools


Domains

API calls are grouped within functional test domains.

REST

SOAP

Description

async

async

Contains methods for so called response queue

automation

automation

Contains methods for automations in Mapp Engage.

blacklist

blacklist

Contains methods  to manage system and group blacklists.

cms

cms

Contains methods  to manage messages stored in  the CMS.

contact

contact

Contains methods for contact management.

user

user

Contains more methods for contact management.

content

content

Contains methods  to manage elements in the Content Store.

draftmessage

draftmessage

Contains methods for working with message saved as a draft.

group

group

Contains all group-related methods.

landingpage

landingpage

Contains methods  to manage landing pages.

membership

membership

Contains methods  to manage group memberships.

message

message

Contains methods to manage email and SMS messages.

meta

meta

Contains methods that define your system.

mobile

n/a

The mobile domain contains methods to manage approx properties

preparedmessage

preparedmessage

A prepared message is a saved message assigned to a group.

process

process

Contains methods to interact with a process in Mapp Engage.

relatedData

relateddata

Contains methods to manage records stored in Related Data.

system

system

Contains methods  about the current version of the system .

systemuser

systemuser

Contains system user-related to system user.

usagestatistics

usagestatistics


  • No labels