Webservices zijn een manier waarop softwareapplicaties met elkaar kunnen communiceren via het web. Dit maakt communicatie mogelijk tussen softwaresystemen die zijn gebouwd met verschillende platforms en programmeertalen. Bijvoorbeeld, een app geschreven in C# die op onze computer draait, kan communiceren met een website via webservices.

Er zijn meerdere typen webservices en het is een breed onderwerp, maar we richten ons op API's omdat dit het meest voorkomende type webservice is. Bovendien zijn API's relevant om op dit niveau te leren.

Een API, ook wel bekend als een Application Programming Interface, is een interface waarmee een client met een server kan communiceren.

Een client is meestal een externe applicatie. Gewoonlijk definiëren we een client als een gebruiker. Meer specifiek is een client echter een applicatie, bijvoorbeeld een webbrowser of een consoleapplicatie. Een client kan ook een onderdeel zijn van één grote applicatie die uit meerdere delen of programmeertalen bestaat.

Een server is een computer die de applicatie host, wat een website, een databasesysteem of iets anders kan zijn.

In de praktijk stuurt een client een bericht naar een server via een webverzoek, en de server verwerkt het verzoek en stuurt een antwoord terug. We leren in het volgende hoofdstuk hoe we webverzoeken kunnen versturen.

Het webverzoek dat we naar de server sturen is specifieker een HTTP-verzoek. HTTP is een protocol voor datacommunicatie tussen een client en een server. Een HTTP-verzoek is een bericht dat van de client naar de server gaat via het HTTP-protocol. We hoeven niet te begrijpen hoe het HTTP-protocol werkt. Wel moeten we weten welke soorten HTTP-verzoeken mogelijk zijn. De vier meest voorkomende typen HTTP-verzoeken zijn:

• GET: Gegevens ophalen van de server. Dit wordt gebruikt om informatie op te vragen en mag geen bijwerkingen op de server hebben;

• POST: Gegevens naar de server sturen om een nieuw resource aan te maken. Dit houdt vaak in dat een database wordt bijgewerkt of formuliergegevens worden verwerkt;

• PUT: Een resource op de server bijwerken. Dit wordt gebruikt om een nieuw resource aan te maken of een bestaand resource volledig te vervangen;

• DELETE: Verzoek om een resource op de server te verwijderen. Dit wordt gebruikt om het opgegeven resource te verwijderen.

Wanneer een client een HTTP-verzoek naar een server stuurt, specificeert de client ook de HTTP-methode in het verzoek. HTTP-methode is simpelweg het type verzoek, d.w.z. GET, POST, PUT, DELETE, enzovoort. Dit helpt de ontvangende server om het verzoek op de juiste manier te verwerken.

Veel van de verwerking vindt plaats aan de API-kant, bijvoorbeeld het ontleden en/of decoderen van het bericht van de client.