---
title: "Een gratis proefsleutel, zonder account."
method: POST
path: "/Api/Proef"
tags: ["Proef"]
---

# Een gratis proefsleutel, zonder account.

`POST /Api/Proef`

## Request

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

Geeft een sleutel voor 5 unieke adressen. Met het e-mailadres van de gebruiker worden het er
10 in totaal en ontstaat er een WozApi-account zonder wachtwoord; de gebruiker krijgt daar een
mail over. De proef telt unieke adressen: hetzelfde adres opnieuw is gratis, en een fout of een
adres zonder WOZ-waarde kost niets.
            
Vraag per gesprek hoogstens een proefsleutel aan, en geen nieuwe als de proef op is.

## Request body

- ProefAanvraag: Verzoek om een gratis proefsleutel. Beide velden zijn optioneel; een lege body mag.
  - `email` string, nullable: Het eigen e-mailadres van de gebruiker, alleen als hij het zelf voor dit doel gaf. Met een e-mailadres worden het 10 adressen in totaal en ontstaat er een account zonder wachtwoord. Verzin er nooit een.
  - `kanaal` string, nullable: Waar de aanvraag vandaan komt: "api" (standaard), "demo" of "mcp".

## Response `200`

De sleutel en het tegoed. De sleutel is alleen in dit antwoord te zien.

- ProefSleutelAntwoord: Een nieuwe proefsleutel. De sleutel is alleen in dit antwoord te zien.
  - `sleutel` string, nullable: De sleutel. Stuur hem mee als header X-Api-Key, nooit in een URL.
  - `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.
  - `email` string, nullable: "ontvangen" als er een e-mailadres meekwam, anders leeg.
  - `gebruik` string, nullable: Hoe je de sleutel gebruikt.
  - `regels` string[], nullable: Regels voor wie namens een gebruiker opvraagt.

## Other responses

- `400`: Het e-mailadres is onbruikbaar (EmailOngeldig).
- `429`: Te veel sleutels vanaf dit netwerk (TeVeelProefsleutels) of te snel achter elkaar (TeVeelVerzoeken).

---

[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)