---
title: "Authenticatie"
source: /nl/gcxone/api/authentication
locale: nl
updated: 2026-09-04
---
Elke endpoint in de Genesis API verwacht een token in de `auth-token` request header. Een verzoek zonder token beantwoordt met `401`.

### Een token verkrijgen

Ruil een API‑credential in voor een token met `POST /proxy/apiToken`. De credential wordt per service‑provider uitgegeven, dus de aanvraag benoemt de provider waarvoor het token moet gelden.

```json
{
  "serviceProviderId": "string (required)",
  "accessId": "string (required)",
  "clientSecret": "string (required)"
}
```

De credential's `accessId` en `clientSecret` worden uitgegeven in het Genesis‑platform onder de instellingen van de service‑provider. Bewaar het geheim op uw server: een token kan naar een browser worden gestuurd, de credential die het uitgeeft mag dat niet.

### Het token gebruiken

```bash
curl -H "auth-token: <token>" https://api.nxgen.cloud/api/v1/user/me
```

`GET /user/me` retourneert het account waartoe het token behoort, wat de snelste controle is dat een token werkt.

### Verzoeken uit de documentatie proberen

De interactieve referentie op [/api-reference](/api-reference) is dezelfde specificatie in Swagger UI, en [the overview](/gcxone/api/overview) somt elke resource op. Druk op **Authorize**, plak een token, en elke **Probeer het** paneel stuurt het als `auth-token`. Het token blijft in uw browser; de verzoeken gaan rechtstreeks van daar naar `https://api.nxgen.cloud/api/v1`.