This API uses the JSONP protocol to support cross domain communication.
Include the following JavaScript file just before the closing tag of your HTML document, this assumes your HTML document resides in the same folder.
<script type="text/javascript" src="diffbot.js"></script>
To access the API, you first need to create an instance of the Diffbot class.
var client = new Diffbot("DIFFBOT TOKEN");Replacing "DIFFBOT TOKEN" with your developer token, obtainable at http://www.diffbot.com/pricing.
The library takes care of passing your API token with all API calls for the lifetime of the object.
Assume that we have our client configured. Now we can call the get function on the article to retrieve the data we need.
The url parameter must be an absolute url of the page you are retreiving data for.
client.article.get({
url: "http://www.xconomy.com/san-francisco/2012/07/25/diffbot-is-using-computer-vision-to-reinvent-the-semantic-web/"
}, function onSuccess(response) {
// output the title
var element = document.getElementById("content");
element.innerHTML = response["objects"][0]["title"];
}, function onError(response) {
switch(response.errorCode) {
case 401:
alert(response.error)
break;
case 404:
alert(response.error)
break;
case 500:
alert(response.error)
break;
}
});The first parameter accepts an object with properties as specified in the DiffBot API documentation which can be found here: http://diffbot.com/products/automatic/article/
The second parameter is a callback function which is called if your lookup to the API is successful. The callback function is passed a single parameter containing a JSON object with all of the information returned from the DiffBot API.
The third parameter is a callback function which is called should an error occur during your lookup. For example if the page you have request cannot be found, the example above demonstrates how you can differentiate between the error types using the errorCode property returned from the API
For detailed documentation of the arguments for the request, and the JSON data returned as part of the response see the DiffBot article documentation. http://diffbot.com/products/automatic/article/
Calling the Analyze API is the same as calling the article API, just calling a different function within the client.
client.analyze.get({
url: "http://www.xconomy.com/san-francisco/2012/07/25/diffbot-is-using-computer-vision-to-reinvent-the-semantic-web/"
}, function onSuccess(response) {
// output the type
var element = document.getElementById("content");
element.innerHTML = response["type"];
}, function onError(response) {
switch(response.errorCode) {
case 401:
alert(response.error)
break;
case 404:
alert(response.error)
break;
case 500:
alert(response.error)
break;
}
});The first parameter accepts an object with properties as specified in the DiffBot API documentation which can be found here: http://diffbot.com/products/automatic/analyze/
The second parameter is a callback function which is called if your lookup to the API is successful. The callback function is passed a single parameter containing a JSON object with all of the information returned from the DiffBot API.
The third parameter is a callback function which is called should an error occur during your lookup. For example if the page you have request cannot be found, the example above demonstrates how you can differentiate between the error types using the errorCode property returned from the API
For detailed documentation of the arguments for the request, and the JSON data returned as part of the response see the DiffBot article documentation. http://diffbot.com/products/automatic/analyze/
Each function has a onError parameter which can be utilised to handle errors returned from the DiffBot API.
The callback function passes a single argument which is an object returned by the service.
Here's an example of an error object returned to the callback function :
{ error: "Not authorized API token.", errorCode: 401 }
-Initial commit by Craig Cooke-