# Snelstart

{% stepper %}
{% step %}

### Aan de slag

Alle API-eindpunten zijn beschikbaar onder de volgende basis-URL:

```
https://api.safegpt.nl/v1/...
```

Om de SafeGPT API te gebruiken, heb je een actief [SafeGPT-account](https://app.safegpt.nl/register). Nadat je account is aangemaakt, kun je je applicatie op een van twee manieren authenticeren:

1. **JWT-token** — een langdurig toegangstoken voor eenvoudige server-to-server-integraties.
2. **OAuth 2.0** — een refresh-tokenstroom met kortdurende toegangstokens.

OAuth 2.0 is de aanbevolen authenticatiemethode voor productie-integraties. Het biedt betere beveiliging omdat toegangstokens kortdurend zijn en kunnen worden vernieuwd met refresh tokens. API-tokens zijn eenvoudiger te implementeren, maar mogen alleen worden gebruikt in vertrouwde backend-omgevingen.

> Stel API-tokens, clientgeheimen, refresh tokens of toegangstokens nooit bloot in frontendcode, mobiele apps, openbare repositories of logs.
> {% endstep %}

{% step %}

### Kies een authenticatiemethode

#### Optie A: JWT-token

Gebruik een API-token wanneer je applicatie draait in een vertrouwde server-side omgeving en je de simpelst mogelijke integratie wilt.

Typische gebruikssituaties:

* Backend-naar-backend-integraties
* Interne services
* Scripts en automatisering
* Ontwikkel- en testomgevingen

Bij API-tokenauthenticatie bevat elke aanvraag je token in de `Authorization` header:

```
Authorization: Bearer YOUR_API_TOKEN
```

Je kunt een langdurig toegangstoken aanmaken door via deze directe link \[[https://app.safegpt.nl](https://app.safegpt.nl/account/apitokens/c6069b30-a950-42e5-8748-1e3f8ae332ec)] te gaan of in te loggen bij SafeGPT en naar \[Instellingen] → \[API-tokens] te gaan. 

#### Optie B: OAuth 2.0

Gebruik OAuth 2.0 wanneer je sterkere beveiliging, tokenrotatie of op gebruiker gebaseerde autorisatie wilt.

Typische gebruikssituaties:

* Productietoepassingen
* Platformen met meerdere gebruikers
* SaaS-integraties
* Toepassingen waarbij toegang per gebruiker of werkruimte kan worden ingetrokken

OAuth 2.0 gebruikt kortdurende toegangstokens. Wanneer een toegangstoken verloopt, gebruikt je applicatie een refresh token om een nieuw toegangstoken op te vragen.

```
Authorization: Bearer YOUR_API_TOKEN
```

{% endstep %}

{% step %}

### Authenticatie

Alle API-aanvragen moeten worden geauthenticeerd met een bearer token. Het token moet worden verzonden in de `Authorization` header.

```
Authorization: Bearer YOUR_API_TOKEN
```

De waarde van `<token>` hangt af van de authenticatiemethode die je gebruikt:

* Gebruik voor API-tokenauthenticatie je langdurige API-token.
* Gebruik voor OAuth 2.0-authenticatie het huidige kortdurende toegangstoken.

Aanvragen zonder geldig bearer token worden geweigerd en resulteren in een 401 unauthorized.

{% endstep %}

{% step %}

### Doe je eerste API-aanvraag

Nadat je een geldig token hebt, kun je je eerste aanvraag aan de SafeGPT API doen.

```
curl -X GET "https://api.safegpt.nl/v1/user/getcurrentuser" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"
```

Als je niet zeker weet of je verbinding hebt met onze API, of als je onze systeemstatus wilt monitoren, kun je altijd het volgende aanroepen:

<mark style="color:groen;">`GET`</mark>  /v1/safegpt/isalive

{% tabs %}
{% tab title="200" %}

```json
{
    "success":true,
    "statusCode":0,
    "message":"Alle SafeGPT-systemen zijn operationeel"
}
```

{% endtab %}
{% endtabs %}

Dit bevestigt dat je token geldig is en dat je applicatie kan communiceren met de SafeGPT API.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.safegpt.nl/api-nl/aan-de-slag/snelstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.