---
title: "Erste Schritte"
source: "https://ayoune.com/es/docs/developer-portal/erste-schritte"
tenant: "tolinax UG"
brand: "aYOUne"
language: "es"
retrieved: "2026-09-11T17:19:59.318Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# 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`:

```bash
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:

```json
{
  "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:

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

Antwortformat:

```json
{
  "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:

```bash
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