---
title: "Het e-mailadres van de gebruiker bij een proefsleutel."
method: POST
path: "/Api/Proef/Email"
tags: ["Proef"]
---

# Het e-mailadres van de gebruiker bij een proefsleutel.

`POST /Api/Proef/Email`

## Request

- Base URL: `https://woz-api.nl`
- URL: `https://woz-api.nl/Api/Proef/Email`
- Auth: API key in header `X-Api-Key`

Met het eigen e-mailadres van de gebruiker worden het 10 adressen in totaal. Er ontstaat een
account zonder wachtwoord, en de gebruiker krijgt een mail met uitleg; daarna koopt hij credits
via een betaallink. Heeft dit adres al een account, dan koppelen we de sleutel daar niet aan:
dat gebeurt pas als de gebruiker zelf inlogt. Het antwoord is in beide gevallen hetzelfde.
Verzin nooit een e-mailadres.

## Request body

- ProefEmailAanvraag: Het e-mailadres van de gebruiker bij een proefsleutel.
  - `email` string, nullable: Het eigen e-mailadres van de gebruiker. Verzin er nooit een.

## Response `200`

Het nieuwe tegoed.

- ProefEmailAntwoord: Antwoord op de e-mailstap: het nieuwe tegoed.
  - `tegoed` TegoedInfo: Het tegoed van een proefsleutel of van een account dat een AI-assistent aanmaakte.
    - `soort` string, nullable: "proef" zolang de sleutel aan geen account hangt, "credits" als hij van een account is.
    - `limiet` integer, nullable: Unieke adressen die deze proef in totaal mag; leeg bij credits.
    - `gebruikt` integer, nullable: Unieke adressen die al gebruikt zijn; leeg bij credits.
    - `resterend` integer: Wat er nog kan: adressen in de proef, of credits op het account.
    - `verlooptOp` string, date-time, nullable: Wanneer een proefsleutel zonder account vervalt.
  - `melding` string, nullable: Wat er met het e-mailadres gebeurt.

## Other responses

- `400`: Het e-mailadres is onbruikbaar (EmailOngeldig).
- `401`: Geen sleutel, of een verlopen sleutel.
- `409`: Aan deze sleutel hangt al een ander e-mailadres (SleutelHeeftAlEmail).

---

[API](https://skmtc.dev/woz-api/apis/wozapi.md) · [All operations](https://skmtc.dev/woz-api/apis/wozapi/llms.txt) · [OpenAPI document](https://skmtc.dev/woz-api/apis/wozapi/revisions/0b2d268e221d?raw)