POST /api/v1/keys

Eigenen API-Key selbst erzeugen

Erzeugt einen API-Key mit hoher Entropie (secrets.token_urlsafe). Der Klartext-Token wird nur EINMAL im data-Envelope zurückgegeben; in Redis liegt ausschließlich der sha256-Hash unter apikey:<hash> (mit TTL), nie der Klartext. Ein gültiger Key im X-API-Key-Header hebt das Rate-Limit an (keyed-Tier). Der Endpunkt selbst ist streng pro IP rate-limitiert, um Key-Flooding zu verhindern. Die Gültigkeit ist rollend: ein Key läuft nur ab, wenn er 30 Tage lang nicht genutzt wird, jede Nutzung verlängert ihn wieder auf 30 Tage.

Parameter

Dieser Endpunkt nimmt keine Parameter.

Code-Beispiele

curl -X POST "https://infranode.dev/api/v1/keys" \
  -H "Content-Type: application/json"

const res = await fetch("https://infranode.dev/api/v1/keys", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
});
const data = await res.json();
console.log(data);

import httpx

res = httpx.post("https://infranode.dev/api/v1/keys")
res.raise_for_status()
print(res.json())

Try it

Für diesen Endpunkt steht keine Live-Konsole bereit. Er ist eine Betriebs- oder Demo-Operation (z.B. erzwungener Fehler oder Schlüssel-Mint) und wird hier nur dokumentiert. Nutze die Code-Beispiele oben für einen direkten Aufruf.