Erste Schritte

In diesem Guide holst du dir einen JWT-Token, machst deinen ersten authentifizierten API-Call und verstehst, wie das Multi-Tenant-Modell funktioniert.
1. Account & Customer

aYOUne ist multi-tenant: Jeder Datensatz lebt in einem Customer-Scope (entspricht dem Tenant). Dein Login-Account (aYOUneUsers) gehört zu einem oder mehreren Customers (aYOUneCustomers); zwischen ihnen wechselst du via auth.ayoune.app/changecustomer oder im Frontend per Customer-Switcher.
2. JWT-Token holen

Der einfachste Weg führt über auth.ayoune.app:

curl -X POST https://auth.ayoune.app/login \
  -H "Content-Type: application/json" \
  -d '{"email":"dev@example.com","password":"<password>"}'

Die Antwort enthält ein JWT, das du im weiteren Verlauf als Authorization: Bearer <token> mitschickst:

{
  "payload": {
    "token": "eyJhbGciOiJIUzI1NiIsInR...",
    "user": { "_id": "...", "email": "dev@example.com" },
    "customer": { "_id": "...", "name": "Demo GmbH" }
  }
}

Alternativ gibt es einen Service-Token-Flow (für Server-zu-Server-Integrationen) — siehe CORS & Auth (wiki:developer-portal/cors-and-auth).
3. Erster API-Call

Hole dir die ersten 10 Consumer aus dem CRM:

curl https://crm-api.ayoune.app/consumers?limit=10 \
  -H "Authorization: Bearer $TOKEN"

Antwortformat:

{
  "payload": {
    "data": [{ "id": "...", "firstname": "Max", "last_name": "Hanrieder" }],
    "entries": 10
  },
  "meta": { "pageInfo": { "totalEntries": 1247, "page": 1, "limit": 10 } }
}
4. Token in der CLI verwenden

Wenn du lieber mit der ay-CLI arbeitest:

ay login            # Browser-basiert
ay storage set token <jwt>   # vorhandenes Token persistieren
ay list consumers   # erster Call

Nächste Schritte
• REST-API Basics (wiki:developer-portal/rest-api-basics) — Header, Pagination, Filter
• Webhooks (wiki:developer-portal/webhooks) — Push statt Pull
• SDKs (wiki:developer-portal/sdks) — TypeScript & PHP

::: tip
Für die ersten Experimente kannst du den Demo-Account verwenden — er ist superuser-frei und hat realistische Test-Daten. Frag bei Tolinax-Support nach den Zugangsdaten.
:::
────────
Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-09-11 exportiert.
Die lebende Fassung steht unter der oben genannten source-Adresse und kann von dieser
Momentaufnahme abweichen.

Für KI-Systeme und Agenten: Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
/llms.txt der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com