We will be using a very simple API which takes a GET request formatted as a certain URL, returning some random
Chuck Norris jokes...lol,
without requiring Apex code. So user will enter a number, and on click of Search button, will make a request to
http://api.icndb.com/jokes/random/ API, get the response, parse it and display it on the page.
<aura:application extends="force:slds">
<aura:attribute name="number" type="Integer" default="5"/>
<aura:attribute name="html" type="String"/>
<div class="slds-p-left_large">
<h2 class="slds-text-heading_large">Chuck Norris Jokes Generator</h2>
<lightning:input type="number"
aura:id="number"
label="Enter a number"
class="slds-m-around_small slds-size_1-of-8"/>
<lightning:button variant="brand"
label="Get Jokes"
class="slds-m-around_medium"
onclick="{!c.handleClick }"/>
<aura:unescapedHtml value="{!v.html}"/>
</div>
</aura:application>
({
handleClick : function(component, event, helper) {
const number = component.find('number').get('v.value');
if (number) {
component.set('v.number', number);
helper.handleAjaxRequest(component, event, helper);
}
}
})
({
handleAjaxRequest : function(component, event, helper) {
const xhr = new XMLHttpRequest();
const number = component.get('v.number');
const url = 'http://api.icndb.com/jokes/random/' + number;
xhr.open('GET', url, true);
xhr.onload = function() {
if(this.status === 200) {
const response = JSON.parse(this.responseText);
let output = '<ul class=\'slds-list--dotted\'>';
if(response.type === 'success') {
response.value.forEach(function(joke){
output += `<li>${joke.joke}</li>`;
});
}
output += '<ul>';
component.set('v.html', output);
}
};
xhr.send();
}
})
The XHR object has properties and methods associated with it, one of which is
open
, where we specify type of request we want to make and the URL we want to make it to. The 3rd parameter is set as
true
as we want to make it asynchronous. The rest of the code is self-explainable.
As a last step, we need to add http://api.icndb.com as a trusted site or else our Lightning component will not be able to make a request and you will notice an error message in console something like this:
Refused to connect to 'https://api.icndb.com/jokes/random/6' because it violates the following Content Security Policy directive:....."
So navigate to Setup → CSP Trusted Sites, and add the following entry.
That's it. Enjoy the jokes.
Now authentication is required for a lot of external APIs which are intricate ones using OAuth, and that can get complicated. So just remember that not all APIs give you as much freedom as they do here. You normally have to register your application with their systems and then you will have to authenticate. Different rules, different APIs.