# Schnellstart

> Richte ein beliebiges HTML-Formular auf Ikiform aus und erhalte deine erste Einsendung in zwei Minuten.

Ikiform ist das Backend für jedes Formular. Du behältst dein eigenes Markup, Framework und Styling. Richte das Formular auf einen Ikiform-Endpunkt aus, und Ikiform validiert jeden Post, filtert Spam, speichert ihn in deinem Workspace, schickt dir eine E-Mail und stellt ihn per signiertem Webhook an deine Systeme zu.

Die Codebeispiele in dieser Dokumentation verwenden die Beispiel-Formular-ID `frm_xxxxxxxxxxxxxxxx`. Ersetze sie durch die ID deines eigenen Formulars, die du in der Übersicht des Formulars im Dashboard findest.

## Wähle, wie du sendest

Jedes Formular bekommt einen öffentlichen Endpunkt, `https://ikiform.com/f/<formId>`. Alles, was einen HTTP-POST senden kann, kann ihn nutzen.

| Du sendest von | Verwende | Anleitung |
| --- | --- | --- |
| Eine einfache HTML-Seite oder ein Website-Baukasten | `<form action>` | [HTML-Formulare](https://ikiform.com/de/docs/html.md) |
| React, Next.js, Vue, Svelte, Astro | `fetch` oder `submit` aus dem SDK | [Anleitungen](https://ikiform.com/de/docs/guides/nextjs.md) |
| Ein Backend, ein Skript oder eine Integration | JSON über HTTPS mit einem Secret Key | [Von einem Server](https://ikiform.com/de/docs/guides/server.md) |
| Ein shadcn/ui-Projekt | Die Registry-Komponente | [shadcn/ui-Komponente](https://ikiform.com/de/docs/shadcn.md) |

## Schnellstart

### Schritt 1: Formular erstellen

Melde dich im [Dashboard](https://ikiform.com/dashboard) an, erstelle einen Workspace und füge ein Formular hinzu. Seine Übersicht zeigt die Endpunkt-URL und fertige Snippets für HTML, JavaScript und React.

Zum Einrichten und Testen brauchst du keinen Tarif. Bis du einen wählst, ist der Workspace im Testmodus: **Send test** und Posts von `localhost` oder `*.local` werden angenommen, Einsendungen echter Besucher werden zurückgehalten.

### Schritt 2: Formular auf den Endpunkt ausrichten

Setze `action` des Formulars auf den Endpunkt und `method` auf `post`. Jedes Eingabefeld mit einem `name` wird zu einem Feld der Einsendung.

`contact.html`:

```html
<form action="https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx" method="post">
  <input name="name" required />
  <input name="email" type="email" required />
  <textarea name="message"></textarea>
  <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden />
  <button>Send</button>
</form>
```

Das versteckte Eingabefeld `_gotcha` ist ein Honeypot. Menschen sehen es nie; Bots, die es ausfüllen, werden als Spam gespeichert. Siehe [Spamschutz](https://ikiform.com/de/docs/spam.md#honeypot).

### Schritt 3: Absenden

Öffne die Seite und sende das Formular ab. Der Browser landet auf der Dankeseite von Ikiform oder auf deiner eigenen Seite, wenn du eine Weiterleitung eingestellt hast. Du kannst auch JSON aus einem Terminal senden:

`Terminal`:

```bash
curl https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada","email":"ada@example.com","message":"Hello"}'
```

Eine JSON-Anfrage bekommt eine JSON-Antwort mit Status `201`:

`201 Created`:

```json
{ "ok": true, "id": "sub_01k7v2c9t3e8m5q4x6z0a1b2c3" }
```

### Schritt 4: Sieh, wie sie ankommt

Die Einsendung erscheint sofort im Dashboard. Füge von dort einen [Webhook](https://ikiform.com/de/docs/webhooks.md) hinzu, um jede an deine App zu senden, oder lies sie mit der [REST API](https://ikiform.com/de/docs/api.md).

## Ausprobieren

Der interaktive Request-Builder auf dieser Seite setzt eine Einsendung aus Feldzeilen zusammen und zeigt den passenden curl-, fetch- und SDK-Code. Mit der Beispiel-Formular-ID zeigt er nur Code; mit deiner eigenen Formular-ID kann er einen echten POST an `https://ikiform.com/f/<formId>` senden und Status und JSON-Antwort ausgeben. Die Anfrage, die er baut, sieht so aus:

```bash
curl https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada","email":"ada@example.com","message":"Hello"}'
```

## Nächste Schritte

- [So funktioniert es](https://ikiform.com/de/docs/how-it-works.md) geht jede Prüfung durch, die ein Post durchläuft.
- [Definiere Felder](https://ikiform.com/de/docs/fields.md), damit Ikiform fehlerhafte Daten mit klaren Feldfehlern ablehnt.
- [Schalte eine Menschlichkeitsprüfung ein](https://ikiform.com/de/docs/spam.md#human-check) und beschränke das Formular auf deine Domains.
- [Prüfe Webhook-Signaturen](https://ikiform.com/de/docs/webhooks.md#verify) in deinem Backend.