# Agenturen, Teams und die API

Wie Agenturen auf Agilis im Namen ihrer Kunden werben, wie Teamrollen, Guthaben und Rechnungen funktionieren und wie Sie die Agilis REST API nutzen.

**Kurz gesagt:** Eine Agentur registriert sich einmal unter ihrem eigenen offiziellen Namen und wirbt für ihre Kunden, indem sie den Namen des jeweiligen Kunden unter **Anzeigename** einträgt. Die Agentur zahlt, verwaltet die Guthaben und erhält die Rechnungen. Entwickler können Angebote und Events über die **Agilis REST API** (https://ads.agilis.dating) mit API-Schlüsseln aus dem Werbeportal erstellen und verwalten; Testschlüssel sind kostenlos und werden Mitgliedern nie angezeigt.

## Für Agenturen

1. **Registrieren Sie die Agentur** unter ihrem eigenen offiziellen Namen. → [So registrieren Sie sich](https://www.agilis.dating/de/business/guide/register)
2. Wenn Sie ein Angebot oder Event erstellen, tragen Sie den **Namen Ihres Kunden** unter **Anzeigename** ein. Mitglieder sehen den Namen des Kunden, nicht Ihren.
3. Sie müssen von jedem Kunden beauftragt sein, für ihn zu werben. Nach den Werbebedingungen ist die Agentur dafür verantwortlich.

**Wer zahlt und wer die Rechnung erhält**

- Es zahlt das Konto Ihrer Agentur, in der Abrechnungswährung Ihrer Agentur.
- Jede Person in Ihrer Agentur hat ein eigenes Guthaben und zahlt daraus. Das Organisationsguthaben ist die Summe. → [So funktionieren Guthaben](https://www.agilis.dating/de/business/guide/pricing)
- Rechnungen und Ergebnisse laufen auf den Namen Ihrer Agentur, eine Rechnung pro Zahlung, sodass Sie die Kosten an jeden Kunden weiterberechnen können.
- Um die Ausgaben je Kunde getrennt zu halten, verwenden Sie pro Kunde ein eigenes Angebot oder Event und berechnen Sie die Kosten anhand der zugehörigen Rechnung weiter.

## Teamrollen

Organisations-Admins und Werbetreibende arbeiten im Werbeportal, Entwickler über die API. Entwickler können im Werbeportal keine Angebote oder Events erstellen, mit ihren API-Schlüsseln aber über die API Angebote und Events erstellen, veröffentlichen und bezahlen. Ihr Unternehmen ist dafür verantwortlich, wie seine Schlüssel verwendet werden. Die vollständige Tabelle finden Sie unter [Teamrollen und Berechtigungen](https://www.agilis.dating/de/business/guide/getting-started).

## Die Agilis REST API

- **Basis-URL:** https://ads.agilis.dating
- **Referenz:** www.agilis.dating/api-doc, mit Beispielen in cURL, Python, Node.js und PHP sowie einem API-Assistenten
- **Maschinenlesbar:** OpenAPI 3.1 unter www.agilis.dating/openapi.json, Markdown unter www.agilis.dating/api-doc.md und der vollständige Text für KI-Tools unter www.agilis.dating/llms-full.txt
- **Angebote:** Ihre Kategorien und die Interessen abrufen; den Preis eines Angebots vor dem Erstellen berechnen; Angebote erstellen, auflisten, pausieren, fortsetzen und löschen; die Ergebnisse jedes Angebots abrufen
- **Events:** Events in der Vorschau ansehen, veröffentlichen, auflisten, bearbeiten, verschieben, absagen und löschen; die Ergebnisse jedes Events abrufen

### API-Schlüssel erhalten

1. Melden Sie sich im Werbeportal als Organisations-Admin oder Entwickler an.
2. Wählen Sie mit dem Schalter oben auf der Seite **Testmodus** oder Livemodus.
3. Gehen Sie zu **API-Schlüssel** → **Neuer Schlüssel**, geben Sie ihm einen Namen und, wenn Sie möchten, ein Ablaufdatum.
4. **Kopieren Sie den Schlüssel sofort.** Sie können ihn später nicht mehr einsehen.

Testschlüssel beginnen mit `pk_test_`, Live-Schlüssel mit `pk_live_`. Jede Person kann pro Modus bis zu 10 Schlüssel haben. **Erneuern** ersetzt einen Schlüssel sofort, aktualisieren Sie also zuerst Ihre Systeme. Senden Sie den Schlüssel im Anfrage-Header `x-api-key`: `x-api-key: pk_test_…`.

### Sicher entwickeln

- Entwickeln und testen Sie mit einem `pk_test_`-Schlüssel: Test-Angebote und -Events sind kostenlos und werden Mitgliedern nie angezeigt.
- Berechnen Sie den Preis eines Angebots vor dem Erstellen über den Endpunkt für Preisschätzungen.
- Halten Sie Schlüssel aus Code-Repositorys und Browsern heraus; rufen Sie die API von Ihrem Server aus auf.

## Fragen

### Kann eine Agentur mehrere Kunden über ein Konto verwalten?

Ja. Registrieren Sie die Agentur einmal und geben Sie bei jedem Angebot oder Event den Namen des Kunden an.

### Kann jeder Kunde eine eigene Rechnung bekommen?

Rechnungen werden an Ihre Agentur ausgestellt, eine pro Zahlung. Berechnen Sie Ihren Kunden die Kosten anhand dieser Rechnungen weiter.

### Gibt es eine Testumgebung (Sandbox)?

Ja. Der Testmodus mit `pk_test_`-Schlüsseln ist eine vollständige Testumgebung. Es wird nichts berechnet und Mitgliedern wird nichts angezeigt.

### Kann ich KI-Programmiertools anbinden?

Ja. Verweisen Sie Ihr Tool auf www.agilis.dating/api-doc.md oder www.agilis.dating/openapi.json.

Source: https://www.agilis.dating/de/business/guide/agencies-and-api