Über die Integration Vollwertige API erzeugen Sie die API-Schlüssel, die den programmatischen Zugriff auf Ihr Personyze-Konto authentifizieren — Lesen und Schreiben von Nutzern, Katalogen, Interaktionen, Platzhaltern und Berichten.
Im Panel: Einstellungen › Integrationen › Vollwertige API.
Einen Schlüssel erzeugen
- Öffnen Sie Einstellungen › Integrationen und klicken Sie auf der Karte „Vollwertige API“ auf Verwalten.
- Erzeugen Sie einen neuen Schlüssel. Bewahren Sie ihn sofort sicher auf — der Wert eines bestehenden Schlüssels lässt sich später nicht wiederherstellen.
- Geben Sie jeder Integration einen eigenen Schlüssel, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.
Das Löschen eines Schlüssels wirkt sofort: Alles, was ihn noch verwendet, erhält ab dann 401. Erzeugen Sie den Ersatz und stellen Sie ihn bereit, bevor Sie den alten widerrufen.
Zapier-Passwörter und Schlüssel der Vollwertigen API sind dieselben Schlüssel. Ein auf einer der beiden Karten erzeugter Schlüssel erscheint auf beiden, und jeder authentifiziert jeden Endpunkt.
Verwendung
Die Authentifizierung erfolgt per HTTP Basic über HTTPS — Benutzername api, Passwort Ihr Schlüssel:
curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/account'Dieser Endpunkt gibt {"id": …} zurück und verändert nichts; damit ist er der einfachste Weg zu prüfen, ob ein Schlüssel funktioniert.
Vollständige Referenz
Die vollständige API-Dokumentation finden Sie im Entwickler-Wiki:
- Überblick über die REST-API — Aufbau von Anfragen, HTTP-Verben, Antwortcodes, Konventionen.
- API-Schlüssel — den Schlüssel senden und testen, Schlüsseltypen und sichere Aufbewahrung.
- Pfadparameter von Anfragen — die Syntax
where/order_by/limit/columns, die alle Objekte gemeinsam haben. - Fehler, Limits und Wiederholungen — Statuscodes, die Obergrenze von 1000 Zeilen, die Indexierungsregeln und was sich gefahrlos wiederholen lässt.
- Eine Integration bauen — welcher Endpunkt was tut und welche Verhaltensweisen überraschen.
Die Objekte
- Nutzer — users, users_columns, user_lists, user_list_users, user_interests, do
- Katalog — products, articles, products_interactions, products_stats
- Analytics — summary_actions, sessions_archive, events, forms
- Konfiguration — placeholders, actions, conditions, containers_grab_variable
Für serverseitige Personalisierung — Personyze fragen, was ein Besucher sehen soll, und es selbst rendern — siehe Serverseitige Personalisierung und A/B-Tests.
Verwandte Artikel
- Zapier-Integration — der No-Code-Weg zur selben API.