Installing and Configuring the Subscribe Library

​

PHP

1. Extract the zip archive, and install it into the proper location for operating system and PHP engine and distribution.
2. Type:
   
   require_once('Vindicia/Soap/Vindicia.php');
   require_once(‘Vindicia/Soap/const.php’);
   
   Note: You must add these require_once statements to every PHP source file which references the Subscribe API in any way.
3. Double check that you have downloaded the correct version for your site, and that the extraction of the archive was completed successfully.

​

Perl

1. Install the modules required by the Perl API client. Type:
   
   sudo perl -MCPAN -e 'install Crypt::SSLeay' 
   sudo perl -MCPAN -e 'install SOAP::Lite'
   
2. Install the API client. Obtain a current copy and place it in a directory. Navigate to that directory in a terminal, and type:
   
   sudo perl Makefile.PL 
   sudo make 
   sudo make install
   
   The Perl client is now installed on your Mac. The default location is /Library/Perl/perl-version, with Vindicia.pm and all the other modules in the Vindicia directory.
3. During development, import the Perl module into your source files. Type:
   
   use Vindicia; 
   use Vindicia::Soap::Vindicia; 
   

​

Configuring the Perl API Client

1. Edit the following fields in vindicia_conf.xml
   • VIN_SOAP_Server: The server’s host name. For example, the name of the Staging development server is soap.staging.us-west.vindicia.com.
   • VIN_SOAP_Version: The version of Subscribe you will call, for example, 4.2.
   • VIN_Server: This value must be 0, which means that this is a Vindicia Perl client, not a server.
   • VIN_Client_Timeout_Usec: The client timeout in milliseconds. For example, for 250 seconds, set the value to 250000.
2. Create a temporary directory on your computer for the client, and then specify the directory’s full path as the value for the following fields:

​

Specifying the First Parameter in Perl

ab = AutoBillFactory::getObject();
ab->fetchCreditHistory($timestamp, $end_timestamp, $page,
page_size);

ab = Vindicia::Soap::AutoBill->new(...);
ab->fetchCreditHistory($ab, $timestamp, $end_timestamp, $page, 
page_size);

​

Java

import com.vindicia.client.ClassName;
import com.vindicia.soap.v4.2.Vindicia.ClassName;

System.*setProperty*("https.proxyHost", "web-proxy.mycompany.com"); 
   // Use the address of your company's proxy server
System.*setProperty*("https.proxyPort", "8080"); 
   // Use the HTTPS port supported by your proxy server

​

.NET With C#

using Vindicia;