API-sleutels

Sleutels zijn voor CI en voor clients die niet via een browser kunnen inloggen. Hoe je er een maakt, hoe deze wordt opgeslagen en hoe je deze intrekt.

Je hebt geen sleutel nodig voor Claude, Cursor, Lovable of ChatGPT: deze loggen in via de browser. Sleutels zijn voor scripts, CI-taken en clients zonder browser.

Maak er een

Open “Agents & API”, typ een label (bijvoorbeeld “CI deploy”) en druk op “Create key” (Sleutel aanmaken). De sleutel wordt één keer getoond, dus kopieer hem nu. Hij ziet eruit als sbe_ak_<id>_<secret>. TileSet slaat alleen een hash van het geheim op, dus kan deze niet opnieuw tonen. Verlies hem en maak een nieuwe aan.

Gebruik hem

Verzend hem als Authorization: Bearer <key> bij verzoeken aan de REST API of de MCP-server. Het beheren van sleutels, het exporteren van je gegevens en het verwijderen van het account vereisen een dashboard-login, geen sleutel. Houd hem uit de sitecode en uit elke pagina: de widget op je pagina heeft nooit een sleutel nodig.

Wat een sleutel kan lezen

Een sleutel stelt widgets in en voert ze uit. Hij leest nooit je inhoud: voor een bron krijgt hij tellingen, zoals hoeveel items hij bevat, hun beoordelingen en hoeveel er foto's hebben, nooit de berichten of recensies zelf. Als een bron faalt, krijgt een sleutel een vaste zin, niet het eigen antwoord van het platform. Om een widget te zien, open https://app.tileset.com/preview/<widgetId>: de widget zoals bezoekers hem zien.

Trek hem in

De lijst op “Agents & API” toont het label van elke sleutel, een gemaskeerde vorm en wanneer deze is aangemaakt. “Revoke” (Intrekken) is een tweestapsknop en wordt onmiddellijk van kracht. Agenten die via de browser-login zijn verbonden, krijgen ook een sleutel, genoemd naar de app (met “OAuth”); het intrekken ervan verbreekt de verbinding van die agent.

Limieten

• Tot 20 actieve sleutels per account, inclusief de sleutels van agenten die via de browser zijn verbonden. Trek er een in om een andere toe te voegen.
• Sleutels die je aanmaakt, verlopen niet; intrekken is hoe ze eindigen. Een agent die via de browser is verbonden, wordt na 90 dagen ongebruik ontkoppeld en vraagt je de volgende keer dat je hem gebruikt opnieuw om goedkeuring.
• Een gelekte sleutel kan je widgets en bronnen bereiken, nooit je platformtokens. Trek hem in en maak een nieuwe aan.