---
title: "Hoe gebruik je Swagger"
slug: "how-to-use-swagger"
description: "Swagger is an interface description language that describes RESTful APIs expressed using JSON. It allows you to create interactive, machine and human-readable."
updated: 2026-07-01T04:57:54Z
published: 2026-07-01T04:57:54Z
canonical: "docs.document360.com/how-to-use-swagger"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hoe gebruik je Swagger

Swagger is een interface description language die RESTful API's beschrijft die met JSON worden uitgedrukt. Het stelt je in staat om interactieve, machine- en mensleesbare API-documentatie te maken. Het helpt je om de middelen van de API te visualiseren en ermee te interageren zonder enige implementatielogica. Het is een webgebaseerde applicatie.

---

## Swagger-documentatiesite

1. Open de [Swagger-documentatiesite](https://apihub.document360.io/).
2. Om de documentatie te authenticeren, klik op **Autoriseren**. Het panel **Beschikbare autorisaties** zal verschijnen.
3. Voer het API-token in in het **Value-veld** .

> [!NOTE]
> OPMERKING
> 
> Je kunt een bestaande token selecteren, of je kunt een nieuwe token genereren volgens jouw wensen. Om een nieuwe token te genereren, volgt u de onderstaande stappen
> 
> - Navigeer naar () in de linker navigatiebalk in het Kennisbankportaal.
> - Ga in het linker navigatiepaneel naar ****Knowledge base portal**** > **API-tokens**.
> - Typ een naam voor het API-token in de **Enter-tokennaam**.
> - Selecteer de vereiste HTTP-methode(s). Je hebt vier methoden onder **Toegestane methode(s):** **GET,** **PUT**, **POST** en **DELETE.**
> - Je kunt alleen het gegenereerde token gebruiken voor de geselecteerde methode(s). Het kan niet worden gebruikt om andere methoden uit te voeren.
> - Klik **op Kopiëren** om het API-token te kopiëren.
4. Klik op de knop **Autoriseren** .
5. Als je klaar bent, klik dan op de **knop Sluiten** . De autorisatie wordt succesvol uitgevoerd.

![Image showing authorize panel in Swagger](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/17_ScreenShot-Swagger.png)

> [!NOTE]
> OPMERKING
> 
> Als je wilt overstappen naar een ander token, klik dan op **Autoriseren** > **Uitloggen** > voer je **API-token** in > **Autoriseren** > **Sluiten**.

### GA

- De **GET-methode** wordt gebruikt om informatie op te halen.
- Hieronder staat een voorbeeld van **een GET-actie** , om alle gegevens over de gebruiker op te halen.

![Image showing GET action in Swagger](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/12_ScreenShot-Swagger_Get.png)

1. Vul de gemarkeerde velden in en klik op de **Uitvoeren-knop** .

De informatie over de gebruiker is beschikbaar onder het gedeelte **Reacties** .

![Image showing GET action in Swagger](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/13_ScreenShot-Swagger_Get.png)

### POST

- De **POST-methode** wordt gebruikt om een item toe te voegen.
- Hieronder staat een voorbeeld van een **POST-actie** , om een gebruiker aan een project toe te voegen.

![Image showing POST action in Swagger](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/14_ScreenShot-Swagger_Post.png)

1. Je moet gebruikersinformatie toevoegen zoals email_id, first_name en last_name om een gebruiker aan het project toe te voegen. De gebruiker wordt aan het project toegevoegd.
2. Klik op de **Uitvoeren-knop** . De toevoeging van de gebruiker zal succesvol zijn als de status 200 is en het succes klopt.

### PUT

- De **PUT-methode** wordt gebruikt om een bestaand item bij te werken.
- Hieronder volgt een voorbeeld van **een PUT-actie** , om een gebruikersrol in het project bij te werken.

![Image showing PUT action in Swagger](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/15_ScreenShot-Swagger_Put.png)

1. Voer de **userId** in het gemarkeerde veld in.
2. Werk de gebruikersrol bij met het nummer dat voor de syntaxis van de gebruikersrol wordt vermeld. De nummers voor de respectievelijke rollen zijn als volgt:
  - 1 → Administrator
  - 2 → Redacteur
  - 3 → Conceptschrijver
  - 4 → Lezer
  - 7 → Eigenaar
3. Als je klaar bent, klik je op de **Uitvoeren-knop** .

De update van de gebruiker is succesvol als de status 200 is en het succes klopt.

### VERWIJDEREN

- De **DELETE-methode** wordt gebruikt om een item te verwijderen.
- Hieronder staat een voorbeeld van een **DELETE-actie** , om een **userId** te verwijderen.

1. Voer de **userId** in het gemarkeerde veld in.
2. Als je klaar bent, klik je op de **Uitvoeren-knop** . Als de status 200 is en het succes klopt, wordt de **userId** succesvol verwijderd.

![Image showing DELETE action in Swagger](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/16_ScreenShot-Swagger_Delete.png)

> [!NOTE]
> OPMERKING
> 
> Het is verplicht om de inhoud in het veld in te voeren die als ***verplicht is gemarkeerd**.

Voor meer informatie, zie de volgende blogs

1. [Ultieme gids om een API-documentatie met voorbeelden te maken](https://document360.com/blog/api-documentation/)
2. [Feature spotlight – API in Document360](https://www.google.com/search?q=Feature+spotlight+%E2%80%93+API+in+Document360&rlz=1C1CHBD_enIN1119IN1119&oq=Feature+spotlight+%E2%80%93+API+in+Document360&gs_lcrp=EgZjaHJvbWUyBggAEEUYOTIGCAEQRRg80gEHNDI5ajBqN6gCALACAA&sourceid=chrome&ie=UTF-8)

---

### Veelgestelde vragen

#### Wat moet ik doen als het verversen van de pagina mijn sessie beëindigt?

Als je de pagina ververst, kan de sessie eindigen en moet je opnieuw authenticeren. Volg de stappen die zijn gegeven voor authenticatie.

#### Hoe moet ik velden opmaken die een specifiek teken vereisen?

Je moet waar nodig een onderstreep gebruiken. Gebruik bijvoorbeeld "email_id" in plaats van "e-mail-id." Het gebruik van spaties zal resulteren in een fout.

## Related

- [Hoe gebruik je Postman](/how-to-use-postman.md)