################################################################################
################################################################################
################################################################################
WARNING: AS OF 2008-02-28 These docs are no longer up to date please see
http://webthumb.bluga.net/apidoc for the current documentation
################################################################################
################################################################################
################################################################################

All requests are made too: http://webthumb.bluga.net/api.php
You submit XML, it doesn't matter what content-type you set

Response is content-type: text/xml on success, and text/plain with a error 
message on failure


Currently failure conditions when making multiple requests (and some are Ok) 
aren't handled well.  You'll get a non specific error message at the end of 
the XML.


################################################################################
Submitting a thumbnail Request (job)
################################################################################

To submit a thumbnail request, send an XML message like
<webthumb>
	<apikey>apikey here</apikey>
	<request>
		<url>webthumb.bluga.net</url>
	</request>
</webthumb>

You can use multiple request nodes, and you can also set the height and width 
of the browser 
<webthumb>
	<apikey>apikey here</apikey>
	<request>
		<url>webthumb.bluga.net</url>
	</request>
	<request>
		<url>webthumb.bluga.net</url>
		<width>300</width>
		<height>300</height>
	</request>
</webthumb>


You'll get a response like:
<webthumb>
	<jobs>
		<job estimate='20' time='2006-08-30 09:39:30' url='http://webthumb.bluga.net'>wt44f5bf42a0e4a</job>
		<job estimate='30' time='2006-08-30 09:39:30' url='http://webthumb.bluga.net'>wt44f5bf42a202f</job>
	</jobs>
</webthumb>

The response contains 1 job line per request, The id in the response (wt*) 
is used to get the status and fetch the image.  You can either store these id's 
and check back in estimate seconds.  Or you make a non specific status request, 
and it will give you the status on any non completed jobs, and any jobs 
completed in the last 6 hours.



################################################################################
Checking the status of a Job
################################################################################

To submit a job status request, send an XML message like
<webthumb>
	<apikey>apikey here</apikey>
	<status>
		<job>wt44f5bf42a0e4a</job>
		<job>wt44f5bf42a202f</job>
	</status>
</webthumb>

You'll get a response back like
<webthumb>
	<jobStatus>
		<status id='wt44f5bf42a0e4a' submissionTime='2006-08-30 09:39:30' 
			browserWidth='1024' browserHeight='768'
			pickup='http://webthumb.bluga.net/data/0e4a/wt44f5bf42a0e4a.zip'
			completionTime='2006-08-30 09:39:38'>Complete</status>
		<status id='wt44f5bf42a202f' submissionTime='2006-08-30 09:39:30' 
			browserWidth='1024' browserHeight='768'
			pickup='http://webthumb.bluga.net/data/202f/wt44f5bf42a202f.zip'
			completionTime='2006-08-30 09:39:41'>Complete</status>
	</jobStatus>
</webthumb>

################################################################################
Checking the status of recent jobs
################################################################################
To submit a job status request, send an XML message like
<webthumb>
	<apikey>apikey here</apikey>
	<status></status>
</webthumb>

You'll get a response back like the one where specific jobs are specified only
the results for all jobs not yet completed and for all the jobs completed in
the last 24 hours (max of 50 results)

################################################################################
Fetching images
################################################################################
To grab an image you can download it directly using the pickup url from
jobStatus or you can use the fetch API

<webthumb>
	<apikey>apikey here</apikey>
	<fetch>
		<job>wt44f5bf42a0e4a</job>
		<size>small</size>
	</fetch>
</webthumb>
	
Possible values for size are: small, medium, medium2, large, zip

The result will be the image data