Feest!🥳 CodeBee bestaat 2 jaar!

We kunnen terugkijken op twee productieve en leerzame jaren. We zijn bezig geweest met het ontwikkelen💻 van een aantal (grote) projecten, waaronder de Tuxis (tuxis.nl) Portal, apps voor Tuxis Ede's Best Run & ArtiLED BV en tal van andere software oplossingen. Daarnaast hebben we een heel arsenaal van koppelingen🔗 gerealiseerd met onder andere Mollie, SnelStart, SendGrid, Kamer van Koophandel én eentje waar we volgende week meer van gaan vertellen. We zullen alvast een tipje van de sluier oplichten: het heeft met telefonie📞 te maken.

Uiteraard kon een lekker stuk taart🍰 niet ontbreken bij zo'n feestje...!

Zin in ook een lekker stukje taart? Dat gaat helaas niet meer... maar niet getreurd, we hebben altijd de koffie☕️ klaar staan (en die is ook lekker), dus kom gerust eens langs in Ede om te bespreken wat we voor u kunnen betekenen!


![CodeBee 2 jaar](https://strapi.codebee.nl/uploads/foto_taart_klein_ab8b1c517d.jpg)


foto_taart.jpg

CodeBee bestaat 2 jaar!

Als developer kun je vandaag de dag niet meer om JSON heen. JSON staat voor JavasScript Object Notation en wordt gebruikt voor het eenvoudig uitwisselen van gestructureerde data. JSON is erg populair binnen de IT-sector, dit komt doordat het formaat makkelijk te lezen is en doordat computers het snel kunnen verwerken. JSON wordt dan ook vaak gebruikt voor de communicatie tussen verschillende systemen. Zo kan er bijvoorbeeld een webshop met een internetkassa via JSON. In dit artikel leggen we uit hoe JSON werkt en waar wij het binnen CodeBee voor gebruiken.

## Hoe werkt JSON?
Om te kunnen weten hoe JSON werkt, hoef je eigen vrij weinig technische kennis te hebben. Dit komt omdat JSON een tekst gebaseerd dataformaat is wat makkelijk wegleest. Er zijn wel een paar condities waaraan het JSON-formaat moet voldoen. Hieronder zijn deze verschillende eisen op een rijtje gezet.

### 1. Een JSON-formaat wordt altijd getoond als een object.

Zoals de naam al zegt is JSON een object volgens de JavaScript notatie. Een JavaScript object wordt binnen accolades geplaatst. Dit zijn de haakjes “{“ en “}”. Het gebruik van deze accolades werkt ook zo bij JSON.

```json
{
// Het JSON formaat begint en eindigt met accolades
}  
```

Een JSON-bestand kan nooit meerdere objecten bevatten. Er is dus altijd één accolade die het bestand opent en sluit.

```json
{
// Het JSON formaat begint en eindigt met accolades
}
{
// Dit zou dus niet werken
}
```

### 2. De data bestaan altijd uit een naam en een waarde

Om de data binnen JSON gestructureerd te houden is deze opgebouwd uit een naam en waarde. De waarde is altijd een string (tekst) en de waarde kan uit verschillende datatypes bestaan. Hieronder bevinden zich enkele voorbeelden met verschillende datatypes.

Een waarde met het datatype **string** (tekst):
```json
{
  "naam":"Michael"
}
```
Een waarde met het datatype **integer** (cijfer):
```json
{
  "leeftijd": 25
}
```

Een waarde met het datatype **float** (decimaal):
```json
{
  "lengte": 1.87
}
```

Een waarde met het datatype **array** (lijst):
```json
{
  "hobbies": ["fitness", "programmeren", "muziek luisteren"]
}
```

Een waarde met het datatype **boolean** (waar/onwaar):
```json
{
  "email_bevestigd": false
}
```

Een waarde met het datatype **null** (lege waarde): 
```json
{
  "bijzonderheden": null
}
```

Tot slot kan een waarde ook bestaan uit een JSON-object. Zo kan JSON bestaan uit meerdere sub objecten. Hieronder bevindt zich een waarde met het datatype **object**:
```json
{
  "gebruiker": {
    "naam": "Michael",
    "leeftijd": 25,
    "lengte": 1.87,
    "hobbies":["fitness", "programmeren", "muziek luisteren"],
    "email_bevestigd":false,
    "bijzonderheden":null
  }
}
```


### 3. De data wordt gescheiden door komma’s.

Binnen JSON worden de regels altijd gescheiden met komma’s. Een uitzondering is de laatste regel van een object. Een komma geeft dus eigenlijk aan dat er nog meer waardes aanwezig zijn binnen het document.

In het vorige code blok is te zien hoe de verschillende regels worden gescheiden met komma’s. Zoals ik al zei heeft de laatste regel geen komma nodig.

## Hoe CodeBee gebruik maakt van JSON

Voor de communicatie tussen verschillende systemen gebruiken we bij CodeBee ook vooral JSON. Dit omdat het makkelijker werkt dan andere dataformaten zoals XML of SOAP. Daarnaast werkt het goed samen met de verschillende frameworks die wij gebruiken zoals FastAPI en ReactJS. Om een beter beeld te geven van hoe JSON gebruikt wordt, zijn hieronder enkele real-life voorbeelden te vinden.

**Het aanmaken van een nieuw adres via een API:**
```json
{
  "city": "Ede",
  "postal_code": "6718XR",
  "street": "Darwinstraat",
  "house_number": 29,
  "addition":"D"
}

```
**Het ophalen van gebruikers:**
```json
{
  "count":3,
  "data": [
    {
        "id":1,
        "username": "michael-12"
    }, {
        "id":2,
        "username":"james3"
    }, {
        "id":3,
        "username":"francis43"
    }
  ]
}
```

## Samenvatten JSON
JSON staat voor _JavasScript Object Notation_ en is een eenvoudig dataformaat dat wordt gebruikt voor het uitwisselen van data. Het JSON-formaat is gemakkelijk te lezen door mensen en gemakkelijk te verwerken door computers. Daarnaast heeft het qua syntax relatief weinig regels. Een goed voorbeeld waarbij JSON gebruikt kan worden is voor de communicatie tussen een webshop en een internetkassa tijdens het afrekenen. 


wat-is-json

Wat is JSON?

Een API is binnen de IT-sector helemaal hot en deze term kom je deze dan ook eigenlijk wel overal tegen. Alleen wat betekent een API nu precies? En wat kan je er dan vervolgens mee? Om je hier een antwoord op te geven leggen we in deze blog het een en ander over API’s uit. Na het lezen van deze blog weet jij alle belangrijke ins en outs over API’s.

## Wat is een API?

Laten we beginnen bij het begin door eerst te bespreken wat een API is. Vandaag de dag zijn softwarepakketten en systemen vaak met elkaar verbonden. Een API, wat staat voor Application Programming Interface, maakt het mogelijk om verschillende systemen gemakkelijk met elkaar te laten communiceren. Zo is er een partij die een verzoek stuurt naar de andere partij en die stuurt hier vervolgens weer een reactie op terug.

## Hoe werkt een API?

Om een duidelijk beeld te geven van hoe API’s werken gebruiken we een ‘real life’ voorbeeld. Stel je eens voor, je neemt plaats in een restaurant en vraagt de ober om de menukaart en besteld vervolgens een lekkere hamburger. De ober geeft deze bestelling door aan de chef die de hamburger vervolgens voor jou klaar maakt. Een tijdje later is jouw hamburger klaar en brengt de ober deze naar je toe. De ober zorgt er dus voor dat het gerecht wat jij wilt bestellen wordt klaargemaakt en vervolgens ook bij jou aan tafel geserveerd wordt.

![Voorbeeld van hoe een API werkt.](https://strapi.codebee.nl/uploads/hoe_werkt_een_api_11a03d74_33e9710b60_2ad52b8ffb_8d50c9d833.svg)

Laten we even teruggaan naar het eerdere voorbeeld van de vliegmaatschappijen. In onderstaand afbeelding is te zien hoe de beschikbare vluchten bij een vliegmaatschappij worden opgehaald via een API. Dit kan natuurlijk veel uitgebreider werken dan dat het nu wordt getoond. Maar het voorbeeld is vooral bedoeld om duidelijk te maken hoe een API de communicatie tussen twee systemen mogelijk maakt.

![De werking van een API bij een vliegmaatschappij](https://strapi.codebee.nl/uploads/hoe_werkt_een_api_11a03d74_33e9710b60_2ad52b8ffb_729a8590f7.svg)

## Hoe wordt er met een API gecommuniceerd?

Nu we hebben uitgelegd hebben hoe een API werkt lichten we ook toe hoe je met een API communiceert. Voor het communiceren met een API worden meestal standaarden gebruikt zodat de software en de API beide weten hoe er gecommuniceerd moet worden. Zonder standaarden zouden beide partijen niet weten hoe ze zouden moeten communiceren en dat wordt natuurlijk een zooitje. De standaarden die je dan ook het meeste ziet zijn JSON en XML. 

 Om een voorbeeld te geven van deze standaarden gebruik ik weer de API van de vliegmaatschappij als voorbeeld. Stel je voor dat je via de API van een vliegmaatschappij alle beschikbare vluchten naar Barcelona wil ophalen. Hieronder bevinden zich de voorbeelden die de API terug zou kunnen sturen.

**JSON formaat**

```json

{
      "datum": "01-08-2022",
      "bestemming": "Barcelona",
      "currency": "EUR",
      "vluchten": [
        {
          "vlucht_nr": "AA001",
          "departure_time": "01-08-2022T08:20+01:00",
          "price": 120.99
        },
        {
          "vlucht_nr": "AA002",
          "departure_time": "01-08-2022T20:20+01:00",
          "price": 112.99
        }
      ]
}
```

**XML formaat**

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<root>
  <datum>01-08-2022</datum>
  <bestemming>Barcelona</bestemming>
  <currency>EUR</currency>
  <vluchten>
    <vlucht_nr>AA001</vlucht_nr>
    <departure_time>01-08-2022T08:20+01:00</departure_time>
    <price>120.99</price>
  </vluchten>
  <vluchten>
    <vlucht_nr>AA002</vlucht_nr>
    <departure_time>01-08-2022T20:20+01:00</departure_time>
    <price>112.99</price>
  </vluchten>
</root>
```

### De verschillende API-types

Om het nog iets ingewikkelder te maken bestaan er meerdere types API’s. Op basis van hoe een API gebruikt gaat worden kan deze onderverdeeld worden onder verschillende types.

#### Private API/ Internal API
Een private API wordt alleen gebruikt binnen de interne systemen van een organisatie. Een voorbeeld is een webshop die alle informatie via een API ophaalt. Deze API wordt alleen gebruikt door de webshop en is dus private.

#### Public API/ Open API
Een public API is voor iedereen toegankelijk. Een voorbeeld is een API voor het ophalen van een weerbericht in bijvoorbeeld Ede. Wat je wel vaak ziet is dat deze API’s‘freemium’ zijn, dus ze zijn gratis toegankelijk voor bijvoorbeeld de eerste duizend verzoeken (requests) per maand.

#### Partner API
De naam zegt het eigenlijk al, een partner API is alleen beschikbaar voor partners van een organisatie. Een partner API biedt vaak extra toegankelijkheid en mogelijkheden voor partners en ondersteund de business-to-business processen. Een goed voorbeeld is de [API van ABN-AMRO](https://developer.abnamro.com/api-products/iban-name-check) die partners de mogelijkheid biedt om een IBAN-check te doen.

#### Composite API
Een composite API bestaat uit minimaal twee van de hierboven genoemde API’s. De API is een combinatie en bestaat dus uit meerdere types. Een voorbeeld hiervan is een private API, waarbij ook enkele onderdelen beschikbaar zijn voor partners.


### Waarom wil je een API gebruiken?

We hebben nu dus gezien wat een API is, hoe deze werkt en welke types er allemaal zijn. Maar waarom zou je een API gebruiken? Er zitten veel voordelen aan het gebruik van een API en deze zetten we even voor je op een rijtje.

#### Toegevoegde klantwaarde
Een API biedt klanten/partners op een veilige manier meer toegang tot software/systemen. Klanten kunnen zo gemakkelijker integreren met bestaande systemen.

#### Gemakkelijk uit te breiden

Omdat API’s modulair worden opgebouwd zijn deze makkelijk en snel uit te breiden.

De API figureert als koppeling tussen twee systemen, beide systemen zijn verplicht om de wijzigingen zo door te voeren dat de API dit kan verwerken. Dit maakt de API onderhoudsvriendelijk.

#### Innovatief

Door een API als datavoorziening te gebruiken kan een organisatie sneller schakelen bij nieuwe ideeën of producten. Er kan dus sneller ingespeeld worden op trends.

#### Meer inzichten

Een API kan ook gemonitord worden, dit geeft een organisatie meer inzicht rondom performance, welke resources er veel opgehaald worden etc.

### Een API voor uw organisatie?

Denk je na het lezen van deze blog: “Een API kan ik ook goed gebruiken voor mijn organisatie of vraagstuk.”, dan helpen wij je graag verder. Binnen CodeBee B.V. zijn wij gespecialiseerd in het bouwen van API’s. Ongeacht waar een API voor nodig is, we helpen graag met het zoeken naar de beste oplossingen. Daarnaast zorgen we dat de API’s goed beveiligd zijn en de data niet zomaar toegankelijk is. Dit doen we onder andere door de API’s te hosten binnen Nederlandse datacenters.

Schieten er vragen over een API bij je te binnen of ben je geïnteresseerd in een API? Neem vrijblijvend contact met ons op. Wij kijken samen graag naar de mogelijkheden!

large_pexels_thisisengineering_3861943_68f15c6e71.webp

Wat is een API en waar wordt het voor gebruikt?

Onze blogs

Ontdek het laatste nieuws en nuttige inzichten over programmeren in Python en NextJS. Leer hoe je efficiënter kunt coderen en blijf op de hoogte van de nieuwste ontwikkelingen in de programmeerwereld. Onze experts in Ede, Nederland, delen hun kennis om jouw programmeervaardigheden naar een hoger niveau te tillen. Lees meer op onze blogpagina!

Blog | CodeBee.nl

large_signal-2023-10-31-151100_002.jpeg

medium_signal-2023-10-31-151100_002.jpeg

small_signal-2023-10-31-151100_002.jpeg

thumbnail_signal-2023-10-31-151100_002.jpeg

codebee-logo-op-muur

Codebee

large_werkwijze-whiteboard-red

medium_werkwijze-whiteboard-red

small_werkwijze-whiteboard-red

thumbnail_werkwijze-whiteboard-red

werkwijze-whiteboard-red

Werkwijze

large_DALL·E 2023-11-06 17.02.39 - Photo of a spacious, open-concept office with large windows allowing natural light. Multiple workstations are set up, all with Python code on the scre.png

medium_DALL·E 2023-11-06 17.02.39 - Photo of a spacious, open-concept office with large windows allowing natural light. Multiple workstations are set up, all with Python code on the scre.png

small_DALL·E 2023-11-06 17.02.39 - Photo of a spacious, open-concept office with large windows allowing natural light. Multiple workstations are set up, all with Python code on the scre.png

thumbnail_DALL·E 2023-11-06 17.02.39 - Photo of a spacious, open-concept office with large windows allowing natural light. Multiple workstations are set up, all with Python code on the scre.png

vacatures-devs-needed

Vacatures

large_pexels-nataliya-vaitkevich-5412270.jpg

medium_pexels-nataliya-vaitkevich-5412270.jpg

small_pexels-nataliya-vaitkevich-5412270.jpg

thumbnail_pexels-nataliya-vaitkevich-5412270.jpg

laptop-on-desk

Software op maat

CodeBee bouwt voor al uw vraagstukken webapplicaties op maat!

large_signal-2023-10-31-151100_004.jpeg

medium_signal-2023-10-31-151100_004.jpeg

small_signal-2023-10-31-151100_004.jpeg

thumbnail_signal-2023-10-31-151100_004.jpeg

webapplicaties-op-maat

Webapplicaties

large_signal-2023-10-31-145948_002.jpeg

medium_signal-2023-10-31-145948_002.jpeg

small_signal-2023-10-31-145948_002.jpeg

thumbnail_signal-2023-10-31-145948_002.jpeg

artiled-mobile-app

Mobiele apps

CodeBee maakt koppelingen tussen uw softwarepakketten

large_signal-2023-10-31-151100_003.jpeg

medium_signal-2023-10-31-151100_003.jpeg

small_signal-2023-10-31-151100_003.jpeg

thumbnail_signal-2023-10-31-151100_003.jpeg

software-koppelingen

Software koppelingen

large_pexels-karolina-grabowska-4195409.jpeg

medium_pexels-karolina-grabowska-4195409.jpeg

small_pexels-karolina-grabowska-4195409.jpeg

thumbnail_pexels-karolina-grabowska-4195409.jpeg

application-management

Applicatie management

large_pexels-brett-sayles-2881224.jpeg

medium_pexels-brett-sayles-2881224.jpeg

small_pexels-brett-sayles-2881224.jpeg

thumbnail_pexels-brett-sayles-2881224.jpeg

network-cables

Hosting services