aYOUne

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.

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": "...", "first_name": "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