Useful Links

Order Now About the API

Sample Code

The following snippets of sample code illustrate the use of the Contact Importer API.

• Perl Example
• PHP Example
• Ruby Example

Perl Example

#!/usr/bin/perl use strict; use warnings; use Digest::MD5 qw(md5_hex); use WWW::Mechanize; my $args = { 'method' => 'import.contacts', 'version' => '1.0', 'web_service_api_key' => 'your API key goes here', 'contact_provider_id' => 'YAHOO', 'user_email_address' => 'your Yahoo email address goes here', 'user_email_password' => 'your Yahoo password goes here', }; my $ss = 'your secret key goes here'; my $cat = ''; my $params = ''; foreach my $key (sort keys %{$args}) { $cat .= $key . $args->{$key}; $params .= $key . '=' . $args->{$key} . '&'; } $cat = $ss . $cat; print "cat: " . $cat . "\n"; my $md5 = md5_hex($cat); print "md5: " . $md5 . "\n"; $params .= 'api_sig=' . $md5; print "params: " . $params . "\n"; my $mech = WWW::Mechanize->new(); my $res = $mech->post('https://api.popularmedia.com/rest', content=> $params); use Data::Dumper; print STDERR "req: " . Dumper($res->request) ."\n"; print STDERR "res: " . Dumper($res) . "\n";

back to the top

PHP Example

The following example was provided by one of our clients (Matthew Encinas, Developer at uPlayMe, Inc.). PLEASE NOTE: This example assumes that you use PHP 5 or higher, and your PHP CURL library has been configured to support HTTPS.

<?php //Example Usage - Fill in your GMAIL info //$xml = get_contacts('exmaple@gmail.com', 'exmaple', 'GMAIL'); //echo $xml; function get_contacts($email, $password, $provider){ $api_url = 'https://api.popularmedia.com/rest/'; $secret = "YOUR_SECRET_KEY"; //Should be stored in your configuration file with all your other passwords etc $service_key = "YOUR_SERVICE_KEY"; $params = "contact_provider_id=$provider&method=import.contacts&user_email_address=$email&user_email_password=$password&version=1.0&web_service_api_key=$service_key"; $temp = preg_replace("/=|\&/", "", $params); //remove "&" and "=" signs from paramters $temp = $secret . $temp; //concatenate secret key with ordered parameters $api_sig = md5($temp); //get hash value $params = $params . '&api_sig=' . $api_sig; //append api_sig to the paramaters $content = get_web_page($api_url, $params); return $content; } //CURL FUNCTION //Function to retrieve content of webpages using php-curl function get_web_page($url, $post_data = '', $test = false){ if($test){ echo 'URL: ' . $url; echo 'POST: ' . $post_data; } //set some options $options = array( CURLOPT_SSL_VERIFYPEER => false, // for HTTPS CURLOPT_RETURNTRANSFER => true, // return web page CURLOPT_FOLLOWLOCATION => true, // follow redirects CURLOPT_USERAGENT => "spiderman", // who am i CURLOPT_CONNECTTIMEOUT => 120, // timeout on connect CURLOPT_TIMEOUT => 120, // timeout on response CURLOPT_MAXREDIRS => 10, // stop after 10 redirects CURLOPT_POST => 1, // enable post CURLOPT_POSTFIELDS => $post_data // data to send via post ); //initialize curl $ch = curl_init($url); //if initialized if($ch){ curl_setopt_array($ch, $options); //apply optioins $content = curl_exec($ch); //execute and return page content $err_num = curl_errno($ch); //numbered error msg (o is good) $errmsg = curl_error($ch); //textual error msg $header = curl_getinfo($ch); //header information curl_close($ch); //close connection if($err_num > 0){ return false; }else{ return $content; } }else{ return false; } } ?>

back to the top

Ruby Example

#!/usr/bin/ruby %w[ rubygems uri net/https digest/md5 ].each do |f| require f end class ShareByEmail def initialize(args ={}) @request_parameters = { 'method' => 'import.contacts', 'version' => '1.0', 'web_service_api_key' => args['my_web_service_key'] || '', 'user_email_address' => args['user_email_address'] || '', 'user_email_password' => args['user_email_password'] || '', 'contact_provider_id' => args['contact_provider_id'] || '' } @shared_secret = args['my_secret_key'] end def get_contacts catd_values = catd_params = '' @request_parameters.keys.sort.each{ |param| catd_values += (param + @request_parameters[param]) } catd_values = @shared_secret + catd_values puts catd_values @request_parameters['api_sig'] = Digest::MD5.hexdigest(catd_values) net_http = Net::HTTP.new('api.popularmedia.com', 443) net_http.use_ssl = true response = nil net_http.start do |http| request = Net::HTTP::Post.new('/rest') request.form_data = @request_parameters response = http.request(request) end return response.body end end sbe = ShareByEmail.new( { 'my_web_service_key' => 'your_web_service_api_key', 'my_secret_key' => 'your_shared_secret', 'user_email_address' => 'your_email_address', 'user_email_password' => 'your_user_email_password', 'contact_provider_id' => 'your_contact_provider_id' }) puts sbe.get_contacts

back to the top