Wat is de betekenis van API

Een API, wat staat voor Application Programming Interface, is eigenlijk een set regels en hulpmiddelen waarmee verschillende softwareprogramma's met elkaar kunnen praten. De API zorgt ervoor dat de data veilig en efficiënt van de ene plek naar de andere plek worden gebracht. Het maakt hierbij dan niet uit of de data opgehaald wordt uit totaal verschillende systemen, omdat de data op gestructureerde manier opgehaald kan worden.

De meeste API’s geven dan ook een JSON response, maar het is ook mogelijk dat dit een API een XML response geeft. Later in dit artikel geven we ook voorbeelden van JSON en XML responses.

Nog even kort, een API stelt verschillende softwareprogramma's in staat om informatie te delen en met elkaar samen te werken. Dit allemaal zonder dat ze hun interne werking hoeven bloot te geven. Denk aan een mobiele app die het weerbericht laat zien. Die app haalt eigenlijk de weerdata van een weer-API, die ergens anders wordt beheerd. Zonder deze API zou de app geen toegang hebben tot actuele weergegevens.

API's maken het dus mogelijk dat onze apps en programma's alle informatie krijgen die ze nodig hebben. Zelfs als die informatie elders wordt bewaard. Ze zijn de bruggen die ervoor zorgen dat al onze digitale tools effectief met elkaar kunnen communiceren.

Wat is een API key?

Een API key is een soort wachtwoord dat softwareprogramma's gebruiken om toegang te krijgen tot bepaalde online diensten of gegevens. Het is eigenlijk een digitale sleutel waarmee je de deur naar een specifieke service kunt ontgrendelen. Deze sleutel wordt verstrekt door de serviceprovider aan ontwikkelaars of gebruikers. Daarbij zorgt het ervoor dat alleen geautoriseerde mensen of programma's toegang hebben tot de gegevens of functies die de API biedt. Het is een belangrijk beveiligingsmechanisme om ervoor te zorgen dat de toegang tot gevoelige informatie of systemen goed wordt gecontroleerd.

Hoe zien een API URL en API key eruit in de code?

Om het nog een stuk duidelijker te maken wat de API key en API URL precies zijn hebben we een stukje Javascript code geschreven waarin je de API key en API URL duidelijk terug ziet komen in de code. Dit is dus een stuk code die gebruikt kan worden om data uit een API op te halen:

// Definieer de URL van de API en je API key
const url = "https://api.example.com/data";
const apiKey = "JOUW_API_KEY_HIER";

// Hierboven vul je de dus de API key in, deze key is bijvoorbeeld: 
// 2345abcde67890fghij12345klmno67890pqrst

// Voer een GET-aanvraag uit met de API key in de headers
fetch(url, {
    method: "GET",
    headers: {
        "Authorization": `Bearer ${apiKey}`

    }
})
    .then(response => {
        if (!response.ok) {
            throw new Error(`Fout: ${response.status}, ${response.statusText}`);
        }
        return response.json();
    })
    .then(data => {
        console.log(data); // Werk met de response data
    })
    .catch(error => {
        console.error("Er is een fout opgetreden:", error);
    });

Hoe werken API’s? Een duidelijk voorbeeld

Stel je voor dat je een bedrijf runt en je wilt een helder overzicht hebben van je financiële cijfers, zoals omzet, kosten en je winst- en verliesrekening. Deze informatie bevindt zich allemaal in een softwarepakket zoals Exact Online. Maar nu wil je deze gegevens niet alleen bekijken als cijfers in een lijst, je wil ze inzien in een dashboard, aangezien dit overzichtelijker is en je hier altijd toegang tot hebt.

Door de API van Exact Online te benaderen kan je vervolgens alle data uit je account ophalen. Het is hier dus wel belangrijk dat je de API key hebt. anders kan er geen data opgehaald worden. Dit is dus eigenlijk een soort wachtwoord.

JSON response vanuit de API

Wanneer de connectie is opgezet kan je de data op gaan halen. Uit Exact Online krijg je bijvoorbeeld de volgende JSON response:

{
  "d": {
    "results": [
      {
        "ID": "c12345d0-1abc-4def-9b12-3456789abcd",
        "Name": "Acme BV",
        "Code": "ACM123",
        "Status": "C",
        "Email": "info@acmebv.com",
        "Phone": "+31 20 123 4567",
        "Country": "NL",
        "AddressLine1": "Energieweg 42",
        "City": "Amsterdam",
        "PostalCode": "1014BV",
        "IsSupplier": true,
        "IsCustomer": true,
        "Website": "http://www.acmebv.com",
        "Created": "2023-01-15T12:30:45Z",
        "Modified": "2024-11-12T09:45:30Z",
        "VATNumber": "NL001234567B01"
      }
    ]
  }
}

Je ziet dat de data heel gestructureerd in een lijst opgehaald wordt in JSON formaat. Deze data kan dus uiteindelijk getransformeerd worden en uiteindelijk gebruikt worden voor data visualisatie.

Voor datavisualisatie kan de data bijvoorbeeld verwerkt worden tot tabellen:
‍

Vanuit hier kan de data gevisualiseerd worden in een dashboard, zodat je voortaan altijd in één oogopslag kan zien hoe je bedrijf ervoor staat. Er kunnen natuurlijk ook nog wel berekeningen op de tabellen uitgevoerd worden, zodat je ook echt mooie verloopgrafieken krijgt van bijvoorbeeld je omzet.

XML response vanuit de API

Wanneer je een XML response zou krijgen zou de data er iets anders uitzien. Je krijgt dan bijvoorbeeld onderstaande response:

<d>
    <results>
        <Account>
            <ID>c12345d0-1abc-4def-9b12-3456789abcd</ID>
            <Name>Acme BV</Name>
            <Code>ACM123</Code>
            <Status>C</Status>
            <Email>info@acmebv.com</Email>
            <Phone>+31 20 123 4567</Phone>
            <Country>NL</Country>
            <AddressLine1>Energieweg 42</AddressLine1>
            <City>Amsterdam</City>
            <PostalCode>1014BV</PostalCode>
            <IsSupplier>true</IsSupplier>
            <IsCustomer>true</IsCustomer>
            <Website>http://www.acmebv.com</Website>
            <Created>2023-01-15T12:30:45Z</Created>
            <Modified>2024-11-12T09:45:30Z</Modified>
            <VATNumber>NL001234567B01</VATNumber>
        </Account>
    </results>
</d>

Je ziet dus dat de XML response anders gestructureerd is. De XML response komt voornamelijk uit SOAP-API's.

Hopelijk is het zo een stuk duidelijker hoe een API echt werkt.

Verschillende soorten API’s

Er zijn verschillende soorten API's die allemaal dienen om verschillende soorten informatie en functies toegankelijk te maken. Een van de belangrijkste categorieën zijn de openbare API's. Deze zijn als openbare informatiebalies waarmee iedereen toegang kan krijgen tot bepaalde gegevens of diensten. Denk aan weer-API's die weerinformatie delen met allerlei weer-apps, of sociale media-API's waarmee je content van sociale platforms kunt delen op andere websites.

Daarnaast zijn er privé-API's, die beperktere toegang bieden en meestal worden gebruikt door specifieke organisaties of ontwikkelaars. Een bedrijf kan bijvoorbeeld een privé-API hebben om interne systemen te verbinden. Deze privé-API's werken vaak als speciale toegangspasjes die alleen aan geautoriseerde personen worden verstrekt.

Wat is een REST API?

Een andere belangrijke soort is de RESTful API, wat staat voor Representational State Transfer. REST API's zijn populair vanwege hun eenvoud en universaliteit. Ze gebruiken standaard HTTP-methoden zoals GET (om gegevens op te halen), POST (om gegevens te creëren), PUT (om gegevens bij te werken), en DELETE (om gegevens te verwijderen). RESTful API's organiseren informatie in hulpmiddelen of bronnen en maken ze toegankelijk via URL's. Bijvoorbeeld, een RESTful API voor een e-commercewebsite zou een URL kunnen hebben om productinformatie op te halen, zoals "website.com/product/123".

Wat is een SOAP API

Een andere categorie omvat de SOAP-API's (Simple Object Access Protocol), die wat complexer zijn en XML gebruiken (zoals eerder toegelicht) om gegevens te verzenden. Ze worden vaak gebruikt in bedrijfsomgevingen voor geavanceerde integraties tussen systemen. Ten slotte zijn er nog RPC-API's, die efficiënt zijn voor het verzenden van gegevens en worden vaak gebruikt voor real-time communicatie tussen systemen.

API's, datawarehouse en datavisualisatie

Als afsluiting willen we benadrukken hoe krachtig de combinatie van API's, datawarehouses en datavisualisatie is. Wanneer je namelijk data van meerdere pakketten wil visualiseren in een dashboard, kan het voor meerdere problemen zorgen als je alle data van verschillende API's los in bijvoorbeeld Power BI zet. Door alle data van verschillende API's in een datawarehouse op te slaan hou je structuur en heb je één plek waar alle data opgeslagen staat.

Buitenom het feit dat je zo veel meer controle hebt over je data, zorgt het er ook voor dat de dashboard optimaal blijven presteren. De data hoeft namelijk maar van één plek opgehaald en vernieuwd te worden. API's in combinatie met een datawarehouse zorgen er dus voor dat waardevolle inzichten en dashboard kan creëren op de best mogelijke manier.

Zo blijf je als bedrijf toekomstbestendig en kan je data echt gaan gebruiken om verder door te groeien.

Bij TapTarget hebben we Taps ontwikkeld, waardoor alle bovenstaande stappen in één klik geregeld worden. Zo bespaar je kostbare tijd en een hoop gedoe. We hebben dit inmiddels voor 20+ databronnen gerealiseerd, waaronder Exact Online, Twinfield, Floriday, Teamleader, Shopify, Plan4Flex en nog veel meer. Omdat wij echt in onze oplossing geloven bieden we ook een 30 daagse gratis proefperiode, zodat je direct de oplossing kan ervaren. Klik hier om naar alle Taps te gaan.

Mocht je nog vragen hebben of je kan je gewenste Tap niet vinden, kan je hier een live demo boeken met ons opnemen. Dan bespreken we graag de mogelijkheden!