WordPress-Plugin und REST-API
Auf dieser Seite
Sie müssen Ihre Website nicht ersetzen. WrkLst versorgt die Website, die Sie schon haben – über das kostenlose WordPress-Plugin oder eine direkte Verbindung für Ihre Entwickler:innen. Beides richten Sie in WrkLst 10 unter Einstellungen ein.
Möchten Sie lieber eine Website, die aus Ihren Daten in WrkLst entsteht, lässt sich eine WrkLst-Website zu Ihrem Tarif hinzufügen – siehe Ihre WrkLst-Website.
Das WordPress-Plugin
Läuft Ihre Website auf WordPress, holt das Plugin die Daten direkt aus WrkLst, sodass die Seiten aktuell bleiben, ohne dass jemand kopiert und einfügt. Es zeigt Werke mit Bild, mit Bildunterschriften und Alt-Texten, sowie Ausstellungen mit ihren Werken, Installationsansichten und Pressetexten. Preise, vertrauliche Notizen oder Kontaktdaten zeigt es nie. Biografien von Künstler:innen werden über die Biografie-Synchronisation unter Einstellungen → Webhook-Sync veröffentlicht – siehe Biografien.
Für die Verbindung legt eine Person, deren Rolle das Recht API-Tokens hat, den Zugangsschlüssel des Plugins an:
- Öffnen Sie Einstellungen → API-Tokens und wählen Sie Token erstellen.
- Geben Sie ihm einen Namen und wählen Sie den Zugriff WordPress-Plugin. Ein Token dieser Art erreicht nur die Website: keine Preise, nichts Vertrauliches, kein Zugriff auf anderes.
- Kopieren Sie das Token sofort – es wird nur dieses eine Mal angezeigt – und tragen Sie es in den Einstellungen des Plugins ein (WrkLst → Einstellungen in WordPress).
Die direkte Verbindung (REST-API)
Für eine Website, die nicht auf WordPress läuft, oder für andere Programme können Entwickler:innen Ihr Konto direkt anbinden. Die Verbindung liest und schreibt Werke, Kontakte, Ausstellungen, Medien, Verkäufe, Listen, Sendungen, Kommissionen und Leads und kann Datensätze suchen und auflisten. Ein darüber angelegter Lead – etwa eine Anfrage aus einem Formular auf Ihrer eigenen Website – kommt als Ungeprüft an, außer der API-Aufruf markiert ihn als geprüft, und alle, deren Einstellung Neue Leads ihn einschließt, werden informiert, auch die Person, der das Token gehört; mit notify: false entsteht er, ohne dass jemand informiert wird – für einen Import oder einen Test. Die Referenz zu jedem Endpunkt steht in WrkLst unter Einstellungen → API-Tokens → API-Dokumentation, mit einer Suche über alle Abschnitte; die Referenz ist auf Englisch.
Einstellungen → API-Tokens.
Einstellungen → API-Tokens → API-Dokumentation.
Tokens legt unter Einstellungen → API-Tokens an, wessen Rolle das Recht API-Tokens hat (Einstellungen → Benutzerrollen); die Rolle Administrator:in hat es. Jedes Token hat eine Zugriffsstufe: Lesen kann alle Module lesen und nichts ändern; Lesen & Schreiben kann lesen, anlegen und ändern, aber nicht löschen; Vollzugriff kann auch löschen; Benutzer handelt als ein bestimmter Benutzer mit genau dessen Rechten – die richtige Wahl für eigene Skripte einer Person. Ein Token kann ein Ablaufdatum haben, wird beim Erstellen einmal angezeigt und lässt sich auf derselben Seite jederzeit widerrufen. Die Person, als die ein Token handelt, braucht in ihrer Rolle unter Einstellungen → Benutzerrollen die Berechtigung API-Zugriff; Administrator-Rollen haben sie von vornherein. Jeder Aufruf steht unter Einstellungen → Interaktionsprotokoll, mit der Person, als die er lief.
KI-Assistenten brauchen kein Token: Sie melden sich mit Ihrem WrkLst-Login an. Siehe KI-Assistenten.
Ihre Daten mitnehmen
Neben den täglichen Exporten als Tabellen, PDFs und Word-Dokumenten können Sie Ihre gesamte WrkLst-Datenbank jederzeit als eine vollständige Datei (SQL-Dump) herunterladen – unter Einstellungen → Backup mit Heutiges Datenbank-Backup erstellen; dieselbe Seite exportiert auch alle Kontakte als vCard und CSV, siehe Backup in Allgemeine Kontoeinstellungen anpassen. Das ist eine komplette Kopie in einem Standardformat, das jede Datenbankfachkraft öffnen kann – ein Abschied von WrkLst bedeutet also nie, Ihre Daten zu verlieren.
Hilfe
Tokens legt in Ihrem Konto an, wessen Rolle das Recht API-Tokens hat. Wenn sich das WrkLst-Team ansehen soll, was Ihre Website zeigen soll, schreiben Sie an support@wrklst.art.