# API-sleutels

> Maak, begrens en beheer sleutels voor de API.

Source: https://reverie.im/nl/docs/integrations/api-keys
Language: nl

Een API-sleutel authenticeert verzoeken aan de [Open API](https://reverie.im/nl/docs/integrations/open-api) van Reverie. Sleutels staan onder **Instellingen → Meer → API-sleutels**, waar ook de Labs-tegel **Open API** naartoe leidt. Elk account kan ze maken — er is geen abonnementsvereiste en geen maximum aan hoeveel je er hebt.

## Een sleutel maken \[#create-a-key]

### Op ‘Nieuwe API-sleutel maken’ drukken \[#press-create-new-api-key]

Op een lege pagina staat op de knop **Maak je eerste API-sleutel**.

### Geef hem een naam \[#name-it]

**Naam** is verplicht, 1–100 tekens. Zo heet de sleutel in de lijst en in de gebruiksstatistieken — ‘Speaker in de woonkamer’, ‘staging worker’.

### Globaal of een specifiek personage kiezen \[#choose-global-or-a-specific-character]

**Personagekeuze** is een keuze tussen \**Globaal (alle personages)*\* en **Specifiek personage**, geen optionele extra. Een specifiek personage wordt het vastgezette personage van de sleutel.

### Eventueel een apparaattype en een vervaldatum instellen \[#optionally-set-a-device-type-and-an-expiry]

**Apparaattype** is vrije tekst (`speaker`, `phone`, `iot`). **Vervaldatum** neemt een datum *en* een tijd; op dat moment stopt de sleutel automatisch met werken.

De sleutel verschijnt meteen als `rk_` gevolgd door 64 hexadecimale tekens.

## Sleutels blijven opvraagbaar \[#keys-stay-retrievable]

Het geheim wordt niet maar één keer getoond. Op de kaart van elke sleutel staan **API-sleutel tonen**, **API-sleutel verbergen** en **API-sleutel kopiëren**, op elk moment, zolang de sleutel bestaat.

> Omdat het volledige geheim leesbaar blijft in je instellingen, staat toegang
> tot je account gelijk aan toegang tot de sleutel. Bewaar de sleutel op een
> server of in een secretmanager, nooit in versiebeheer of in browsercode.

## Globale sleutels en vastgezette sleutels \[#global-keys-and-pinned-keys]

|                           | **Globaal (alle personages)**       | **Specifiek personage**                                                      |
| ------------------------- | ----------------------------------- | ---------------------------------------------------------------------------- |
| `GET /models` geeft terug | Je recente personages               | De scenario's van dat personage, of het personage zelf als het er geen heeft |
| `model` weggelaten        | Valt terug op je meest recente chat | Gebruikt het vastgezette personage                                           |
| Korte scenario-ID's       | Worden nooit opgelost               | Worden opgelost tegen het vastgezette personage                              |

## Uitschakelen, verwijderen, vervangen \[#disable-delete-rotate]

| Actie                 | Effect                                                                  | Omkeerbaar |
| --------------------- | ----------------------------------------------------------------------- | ---------- |
| Schakelaar **Actief** | Verzoeken met de sleutel worden geweigerd zolang hij uit staat          | Ja         |
| **Verwijderen**       | De sleutel wordt vernietigd en apps die hem gebruiken verliezen toegang | Nee        |

Er is geen aparte actie om in te trekken — uitschakelen en verwijderen zijn de twee opties.

> Een sleutel verwijderen kan niet ongedaan worden gemaakt, en de toewijzing
> verdwijnt mee: het eerdere verkeer van die sleutel verhuist naar een bak
> **Verwijderde sleutels** in de gebruiksstatistieken, waar je niet meer kunt
> zien welke integratie wat heeft uitgegeven. Schakel een sleutel eerst uit als
> je de geschiedenis misschien nog wilt hebben.

Om te vervangen maak je eerst de nieuwe sleutel, zet je die in gebruik, en schakel je daarna de oude uit of verwijder je hem. Er is geen automatische vervanging en geen respijtperiode na het verlopen — een verlopen sleutel wordt bij het volgende verzoek geweigerd met `api_key_expired`.

## Bereik \[#scopes]

Sleutels hebben een bereik (scopes), en het dialoogvenster voor het maken toont dat niet. Een sleutel die je in Instellingen maakt, kan de chat-endpoints aanroepen, en alleen die.

Het endpoint van de personage-importer heeft een ander bereik nodig, en de enige manier om zo'n sleutel te krijgen is door **Labs → Skill voor personage-import** te openen; daar wordt er een voor je gemaakt met de naam \*\*Reverie Character Importer (Skill)\*\*. Roep je de importer aan met een gewone sleutel uit de instellingen, dan krijg je een 403 terug. [Personages importeren →](https://reverie.im/nl/docs/characters/import-characters)

## Gebruiksstatistieken \[#usage-statistics]

Het paneel **Gebruiksstatistieken** op dezelfde pagina toont **Verzoeken**, **Tokens**, **Credits** en **Actieve sleutels**, gegroepeerd per UTC-dag, met een uitsplitsing per sleutel onder **Gebruik per sleutel**. Filter op één sleutel of op **Alle sleutels**, over een periode van 7 tot 90 dagen — standaard 30. Alleen chats die via de API zijn gemaakt, worden meegeteld.

Dit paneel is de enige plek waar uitgaven per sleutel bestaan. Je creditgeschiedenis houdt bij wat elk bericht kostte, maar koppelt een transactie niet aan de sleutel die hem deed, dus gebruik de statistieken hier om integraties te vergelijken.

## Een verzoek opbouwen \[#build-a-request]

**Verzoek opbouwen** opent een generator: kies een van je actieve sleutels, kies een personage of scenario uit de lijst die die sleutel kan zien, typ een bericht, kies streaming en temperatuur, en kopieer dan werkende cURL-, TypeScript- of Python-code.

De sleutel wordt in je browser alleen gebruikt om de lijst met personages te laden. De gegenereerde code leest `REVERIE_API_KEY` uit de omgeving in plaats van het geheim erin op te nemen.

## Limieten \[#limits]

| Limiet                                          | Waarde                                                |
| ----------------------------------------------- | ----------------------------------------------------- |
| Sleutels per account                            | Geen limiet                                           |
| Snelheidslimiet per sleutel                     | Geen                                                  |
| Maximum aan gelijktijdige verzoeken per sleutel | Geen                                                  |
| Wat het gebruik echt begrenst                   | Je creditsaldo, plus het venster van het gratis model |

## Gerelateerd \[#related]

* [Open API](https://reverie.im/nl/docs/integrations/open-api) — endpoints, opbouw van verzoeken en fouten
* [Personages importeren](https://reverie.im/nl/docs/characters/import-characters) — waar de importersleutel voor is
* [Reverie Labs](https://reverie.im/nl/docs/integrations/labs) — de tegels Open API en importer
* [Beveiliging](https://reverie.im/nl/docs/account/security) — de overige toegangsinstellingen van je account