Thumbnail API Documentation
Version 2
View Example PHP Implementation
SAMPLE KEY GENERATOR:
#!/usr/local/bin/php
<?php
/* this is a simple command line script example of how to request a valid thumbnail url */
/* SHELL# ./thumbnail-example.php mysite.com */

function main ($domainName = NULL, $type = 'info/json') {
	if (empty ($domainName) || empty ($type)) return false;
	$secret = "mytopsecretcodenooneelsewillhave"; // <-- your secret code, provided by your account representative
	$partnerName = "partnername"; // <-- your partner name, provided by your account representative
	$timestamp = NIResourceAuthenticator::getTimestamp ();
	$hash = NIResourceAuthenticator::getHash ($domain, $timestamp,$partnerName, $secret);
	$url = "http:/thumbnails.nameintel.com/" . $partnerName . "/" . $timestamp . "/" . $hash . "/" . $domainName . "/" . $type;
	return $url;
}
?>
Notes:
  1. You must generate a URL with your key before each subsequent image request.
  2. The key generator returns a valid request URL which can be included in your website.
  3. Type can be 'info/json', 'thumbnail/0/current.jpg', or 'fullsize/0/current.jpg'.
  4. If you are requesting the info/json type, your server must parse the returned JSON object for the relevant historic image URLs. The other requests send a standard image binary of the most recent capture.
  5. If the JSON request is being made by a web browser, connection security restrictions will prevent you from accessing it from a remote URL. You will have to create a request proxy on your server to capture and send the data to the browser.

EXAMPLE JSON RESPONSE (Parsed)
The following decoded response is exemplary of what you might receive as part of the info/json request type. In addition to the current thumbnail and full size request types, the JSON object returned contains URLs and META data for historic thumbnails--as part of its structure.
object(stdClass)#1 (7) {
  ["domain"]=>
  string(8) "xombo.ca"
  ["newest"]=>
  string(10) "1218004032"
  ["generation"]=>
  string(32) "6786ac78675b69aa81fb2e70d150d12f"
  ["datecount"]=>
  int(2)
  ["images"]=>
  array(2) {
    [0]=>
    array(2) {
      [0]=>
      object(stdClass)#2 (6) {
        ["url"]=>
        string(130) "/partnername/2008-08-07T23:52:08.000Z/OxLWKW0c1LM8g19pRCE3sohgToU=/xombo.ca/thumbnail/6786ac78675b69aa81fb2e70d150d12f/1218004032.jpg"
        ["height"]=>
        int(312)
        ["width"]=>
        int(250)
        ["version"]=>
        int(3)
        ["taken"]=>
        string(10) "1218004032"
        ["type"]=>
        string(9) "thumbnail"
      }
      [1]=>
      object(stdClass)#3 (6) {
        ["url"]=>
        string(129) "/partnername/2008-08-07T23:52:08.000Z/OxLWKW0c1LM8g19pRCE3sohgToU=/xombo.ca/fullsize/6786ac78675b69aa81fb2e70d150d12f/1218004032.jpg"
        ["height"]=>
        int(1000)
        ["width"]=>
        int(800)
        ["version"]=>
        int(3)
        ["taken"]=>
        string(10) "1218004032"
        ["type"]=>
        string(8) "fullsize"
      }
    }
    [1]=>
    array(2) {
      [0]=>
      object(stdClass)#4 (6) {
        ["url"]=>
        string(132) "/partnername/2008-08-07T23:52:08.000Z/OxLWKW0c1LM8g19pRCE3sohgToU=/xombo.ca/thumbnail/6786ac78675b69aa81fb2e70d150d12f/2.1217919600.jpg"
        ["height"]=>
        int(0)
        ["width"]=>
        int(250)
        ["version"]=>
        int(2)
        ["taken"]=>
        string(10) "1217919600"
        ["type"]=>
        string(9) "thumbnail"
      }
      [1]=>
      object(stdClass)#5 (6) {
        ["url"]=>
        string(131) "/partnername/2008-08-07T23:52:08.000Z/OxLWKW0c1LM8g19pRCE3sohgToU=/xombo.ca/fullsize/6786ac78675b69aa81fb2e70d150d12f/2.1217919600.jpg"
        ["height"]=>
        int(0)
        ["width"]=>
        int(500)
        ["version"]=>
        int(2)
        ["taken"]=>
        string(10) "1217919600"
        ["type"]=>
        string(8) "fullsize"
      }
    }
  }
  ["oldest"]=>
  string(10) "1217919600"
  ["imagecount"]=>
  int(3)
}

ERROR RESPONSES
    In the event of an error. The request URL will return an empty response.