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
- Registrieren Sie die Agentur unter ihrem eigenen offiziellen Namen. → So registrieren Sie sich
- Wenn Sie ein Angebot oder Event erstellen, tragen Sie den Namen Ihres Kunden unter Anzeigename ein. Mitglieder sehen den Namen des Kunden, nicht Ihren.
- 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
- 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.
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
- Melden Sie sich im Werbeportal als Organisations-Admin oder Entwickler an.
- Wählen Sie mit dem Schalter oben auf der Seite Testmodus oder Livemodus.
- Gehen Sie zu API-Schlüssel → Neuer Schlüssel, geben Sie ihm einen Namen und, wenn Sie möchten, ein Ablaufdatum.
- 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.
