This article defines the preliminary steps and recommended approaches for integrating with Higher Logic Thrive Marketing Professional (Thrive Marketing Professional).
Assumptions
This article assumes that you, as a partner's developer, have a working knowledge of:
- web services
- XML
Setup
Here are the steps to set-up your environment to work with Thrive Marketing Professional.
- Ensure that your firewall will allow a connection to Thrive Marketing Professional’s web service. (Thrive Marketing Professional IP is 205.201.40.0 /29 (255.255.255.248) for US and for CA, 205.201.45.0 /29 (205.201.45.0 through 205.201.45.7))
- You will need to provide us with a list or range of IP addresses that your API requests will originate from. We will add those to a list of allowed IP addresses during the brand creation process.
- Get your Thrive Marketing Professional brand ID and brand name from your eMarketing Advisor.
- Decide if you will employ encryption.
- If no, then a user name and password will be established in the brand.
- If yes, Higher Logic will provide you with an encryption key.
Development approach
Before integrating with Thrive Marketing Professional, we recommend that you approach your development in the following manner.
- Create a basic web service client that can establish a connection.
- Implement compression and authentication. (Authentication requires a user name and password in the brand you are working with.)
- Implement a GridRequest message.
- Add the implementation of encryption. (Coordinate with Higher Logic around the setup of the encryption key.)
- Test the updated encryption implementation with the GridRequest message.
- Implement the balance of the messages needed for your purposes.
Test environment
You will be able to test your work via our public interface at https://partnertest.informz.net/aapi/InformzService.svc
Moving to production
Once development and testing are complete, the final step is to move the work to production. Here are the steps you will have to perform to do this:
- Change the endpoint URL to point to one of the following locations:
- US: https://partner.informz.net/aapi/InformzService.svc (rather than partnertest)
- Canada: https://partner.informz.ca/aapi/InformzService.svc
- Create user account in Thrive Marketing Professional if this is different than what was used during development. This can be done either by a single Thrive Marketing Professional account used for all calls, or existing user credentials can be passed in to support auditing of the messages.