Authenticatie

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.

{
  "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

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 is dezelfde specificatie in Swagger UI, en the 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.