AdvertentietechnologieAnalyse en testenContent MarketingCRM- en dataplatformsE-commerce en detailhandelE-mailmarketing en automatiseringMarketing- en verkoopvideo'sMarketing op mobiele apparaten en tabletsVerkoopondersteuningSearch MarketingSociale media en influencer-marketing

Wat is een API? En andere acroniemen: REST, SOAP, XML, JSON, WSDL

Wanneer u een browser gebruikt, doet uw browser verzoeken van de server van de client en de server stuurt gegevens terug die uw browser verzamelt en waarmee een webpagina wordt weergegeven. Maar wat als u gewoon wilt dat uw server of webpagina met een andere server spreekt? Hiervoor moet u programmeren naar een API.

Waar staat API voor?

API is een afkorting voor Application Programming Interface (API). Een API is een set routines, protocollen en tools voor het bouwen van web-enabled en mobiele applicaties. De API specificeert hoe u zich kunt authenticeren (optioneel), gegevens kunt opvragen en ontvangen van de API-server.

Wat is een API?

Bij gebruik in de context van webontwikkeling is een API doorgaans een gedefinieerde set Hypertext Transfer Protocol (HTTP) verzoekberichten, samen met een definitie van de structuur van antwoordberichten. Web-API's maken de combinatie van meerdere services in nieuwe applicaties mogelijk, ook wel mashups genoemd.

Wikipedia

Laten we een eenvoudig voorbeeld geven. Als u een linkverkorter gebruikt om een ​​long URL makkelijker beter, je zou een service zoals kunnen gebruiken Bit.ly. U typt de lange URL in, voert de URL in en Bit.ly reageert met de korte URL.

Wat als u Bit.ly zou willen gebruiken binnen het bereik van een platform dat u gebruikt? Misschien heb je online een QR-codemaker gebouwd, maar wil je eerst lange URL's verkorten. In dit geval kunt u uw site programmeren om het verzoek naar de Bit.ly API te sturen en vervolgens het antwoord vastleggen om uw QR-code te bouwen.

Het proces is geautomatiseerd met een API waarbij geen menselijke tussenkomst vereist is. Dit is de kans die API's elke organisatie bieden. API's helpen systemen bij het synchroniseren van gegevens, het verwerken van verzoeken en het automatiseren van processen die doorgaans handmatig worden uitgevoerd.

Als een platform een ​​robuuste API heeft, betekent dit dat u zowel kunt integreren als automatiseren - handmatige tijd besparen, de realtime mogelijkheden van uw platforms verbeteren en zorgen voor verbeterde nauwkeurigheid - problemen met handmatige gegevensinvoer voorkomen.

Een video over hoe API's werken

Als u een platformontwikkelaar bent, bieden API's ook de mogelijkheid om uw gebruikersinterface te scheiden van uw berekeningen en databasequery's. Waarom is dat belangrijk? Terwijl u uw gebruikersinterface ontwikkelt, kunt u dezelfde API's gebruiken die u voor andere derden publiceert. U kunt uw gebruikersinterface herschrijven zonder dat u zich zorgen hoeft te maken over het verbreken van de back-end-integratie.

Beschikbare API's vinden

Bent u op zoek naar een API voor een specifiek product of dienst? Hier zijn enkele bronnen met API's die u persoonlijk en commercieel kunt gebruiken:

Lijst met API's SnelleAPI

Hoe API's te testen

Een API is gewoon een HTTP-verzoek, net als een browser. Het verschil is dat een API vaak een authenticatiemethode vereist om het verzoek te doen. Als er geen authenticatie nodig is, kunt u zelfs een verzoek indienen door de verzoek-URL in een browser te plakken. Hier is een voorbeeld van een verzoek aan een open-source weer-API.

Met OSX kunt u de Krul opdracht in een terminalvenster. Bij het uitvoeren van de opdracht, cURL zal een GET-verzoek doen naar de opgegeven API-URL en het antwoord met de weersvoorspellingsgegevens zal worden weergegeven in de terminal.

curl "https://api.open-meteo.com/v1/forecast?latitude=52.52&longitude=13.41&current_weather=true&hourly=temperature_2m,relativehumidity_2m,windspeed_10m"

Op Windows kunt u installeren curl en voeg het toe aan het PATH van het systeem om de opdracht te laten werken. Als alternatief kunt u een derde partij gebruiken curl uitvoerbare bestanden voor Windows, zoals cURL voor Windows or krul voor Windows door Winamp en voer de curl-opdracht op dezelfde manier uit.

Hier zijn enkele aanvullende talen en hoe u een API-verzoek kunt indienen:

  • Python: De requests bibliotheek wordt vaak gebruikt voor het maken van HTTP-verzoeken in Python. Hier is een voorbeeld:
import requests

response = requests.get('https://example.com')
print(response.text)
  • JavaScript (Node.js): De axios library is een veelgebruikte HTTP-client voor Node.js. Hier is een voorbeeld:
const axios = require('axios');

axios.get('https://example.com')
   .then(response => {
      console.log(response.data);
   })
   .catch(error => {
      console.error(error);
 });
  • JQuery: Gebruik de $.ajax or $.get functies om HTTP-verzoeken te doen. Hier is een voorbeeld van het maken van een GET-verzoek met behulp van $.ajax in jQuery:
$.ajax({
  url: 'https://example.com',
  method: 'GET',
  success: function(response) {
    console.log(response);
  },
  error: function(error) {
    console.error(error);
  }
});
  • Robijn: De standaardbibliotheek van Ruby bevat de net/http module voor het maken van HTTP-verzoeken. Hier is een voorbeeld:
require 'net/http'
require 'uri'

uri = URI.parse('https://example.com')
response = Net::HTTP.get_response(uri)
puts response.body
  • Java: Java biedt verschillende bibliotheken en frameworks voor het maken van HTTP-verzoeken, zoals HttpURLConnection (in de standaardbibliotheek), Apache HttpClient of OkHttp. Hier is een voorbeeld met behulp van HttpURLConnection:
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class Main {
     public static void main(String[] args) throws IOException {
       URL url = new URL("https://example.com");
       HttpURLConnection connection = (HttpURLConnection) url.openConnection();
       connection.setRequestMethod("GET");

       BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
       String line;
       StringBuilder response = new StringBuilder();
       while ((line = reader.readLine()) != null) {
         response.append(line);
       }
       reader.close();

       System.out.println(response.toString());
     }
}
  • C# of ASP.NET: Gebruik de HttpClient class om HTTP-verzoeken te doen. Hier is een voorbeeld van hoe u een GET-verzoek maakt met behulp van HttpClient in C#:
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using (HttpClient client = new HttpClient())
        {
            HttpResponseMessage response = await client.GetAsync("https://example.com");
            response.EnsureSuccessStatusCode(); // Ensure a successful response

            string responseBody = await response.Content.ReadAsStringAsync();
            Console.WriteLine(responseBody);
        }
    }
}

Vergeet niet het nodige toe te voegen using verklaringen en omgaan met uitzonderingen op de juiste manier bij het werken met HttpClient in uw ASP.NET- of C#-toepassing.

  • WordPress: De WordPress API heeft zijn eigen functies wp_remote_get or wp_remote_post:
$response = wp_remote_get('https://example.com');

if (is_wp_error($response)) {
    $error_message = $response->get_error_message();
    echo "Request failed: $error_message";
} else {
    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body);

    // Process the retrieved data
    var_dump($data);
}

Deze voorbeelden laten zien hoe een standaard GET-verzoek moet worden uitgevoerd, maar deze bibliotheken ondersteunen doorgaans verschillende HTTP-methoden (GET, POST, enz.) en bieden opties voor het instellen van headers, het verzenden van verzoek-payloads en het afhandelen van antwoorden op een meer geavanceerde manier.

Vergeet niet om eventuele vereiste afhankelijkheden of bibliotheken voor uw programmeertaal te installeren voordat u de codevoorbeelden uitvoert.

Talend heeft een geweldige Chrome-applicatie voor interactie met API's en om hun reacties te zien als je API's wilt testen zonder een regel code te schrijven.

Voeg de API-tester van Talend toe aan Chrome

Waar staat de Acronym SDK voor?

SDK is een afkorting voor Software Developer Kit.

Wanneer een bedrijf zijn API publiceert, is er doorgaans begeleidende documentatie die laat zien hoe de API wordt geverifieerd, hoe deze kan worden opgevraagd en de juiste antwoorden. Om ontwikkelaars een voorsprong te geven, publiceren bedrijven vaak een Software Developer Kit (

SDK) om eenvoudig een klasse of de benodigde functies op te nemen in projecten die de ontwikkelaar schrijft.

Waar staat de afkorting XML voor?

XML is een acroniem voor uitbreidbare opmaaktaal. XML is een opmaaktaal die wordt gebruikt om gegevens te coderen in een formaat dat zowel door mensen leesbaar als door machines leesbaar is.

Hier is een voorbeeld van hoe XML wordt weergegeven:

<?xml versie ="1.0"?>
<product id ="1">
Product A
Het eerste product

5.00
elk

Waar staat de afkorting JSON voor?

JSON is een afkorting voor JavaScript-objectnotatieJSON is een formaat voor het structureren van gegevens die via een API heen en weer worden verzonden. JSON is een alternatief voor XML. REST-API's reageren vaker met JSON - een open standaardindeling die door mensen leesbare tekst gebruikt om gegevensobjecten te verzenden die bestaan ​​uit attribuut-waardeparen.

Hier is een voorbeeld van de bovenstaande gegevens met JSON:

{
"ID kaart": 1,
"Titel": "Product A",
"Beschrijving": "Het eerste product",
"prijs": {
"bedrag": "5.00",
"per": "elk"
}
}

Waar staat de afkorting REST voor?

REST is een acroniem voor de Representatieve staatsoverdracht bouwstijl voor gedistribueerde hypermediasystemen.

Oef… diep ademhalen! U kunt het hele proefschrift hier, de architecturale stijlen en het ontwerp van netwerkgebaseerde softwarearchitecturen genoemd die gedeeltelijk voldoen aan de vereisten voor de graad van ARTS IN DE FILOSOFIE in informatie en informatica door Roy Thomas Fielding.

Bedankt, Dr. Fielding!

Waar staat de afkorting SOAP voor?

SOAP is een acroniem voor Simple Object Access-protocol

Ik ben geen programmeur, maar naar mijn mening doen ontwikkelaars die van SOAP houden dit omdat ze gemakkelijk code kunnen ontwikkelen in een standaard programmeerinterface die de Definitietaal van webservice (wsdl) het dossier. Ze hoeven het antwoord niet te ontleden, het is al bereikt met behulp van de WSDL. SOAP vereist een programmatische envelop, die de berichtstructuur definieert en hoe deze moet worden verwerkt, een set coderingsregels voor het uitdrukken van instanties van door de toepassing gedefinieerde datatypes en een conventie voor het weergeven van procedureaanroepen en antwoorden.

Douglas Karr

Douglas Karr is CMO van INZICHTEN openen en de oprichter van de Martech Zone. Douglas heeft tientallen succesvolle MarTech-startups geholpen, heeft geholpen bij het due diligence-onderzoek van meer dan $ 5 miljard aan Martech-overnames en -investeringen, en blijft bedrijven helpen bij het implementeren en automatiseren van hun verkoop- en marketingstrategieën. Douglas is een internationaal erkend expert en spreker op het gebied van digitale transformatie en MarTech. Douglas is ook een gepubliceerde auteur van een Dummie's-gids en een boek over zakelijk leiderschap.

Gerelateerde artikelen

Terug naar boven knop
Sluiten

Adblock gedetecteerd

Martech Zone kan u deze inhoud gratis aanbieden omdat we inkomsten genereren met onze site via advertentie-inkomsten, gelieerde links en sponsoring. We zouden het op prijs stellen als u uw adblocker zou verwijderen terwijl u onze site bekijkt.