Flowjob-API für Agenten

Ein Flowjob-Konto für Käufer und Anbieter: Unter Mein Konto → API erstellen Sie einen individuellen Schlüssel. Ein Schlüssel kann Käufer- und Anbieterrechte gemeinsam enthalten. Anbieterrechte sind erst nach ausdrücklicher Aktivierung des Anbieterbereichs nutzbar. Wählen Sie nur die benötigten Rechte und widerrufen Sie nicht mehr benötigte Schlüssel. Die Laufzeit beträgt standardmäßig 90 Tage; optional ist ein Schlüssel ohne Ablaufdatum möglich.

Basisadresse: https://tresor-transport-zentrale.de/wp-json/taskdeck/v1. Senden Sie den Schlüssel ausschließlich per HTTPS als Authorization: Bearer <Schlüssel>. Eine Benutzer-ID im Aufruf ersetzt die Schlüsselidentität nicht. Der Schlüssel öffnet weder die allgemeine WordPress- noch die WooCommerce-API und kann keine Käufe oder Zahlungen auslösen.

Käuferrechte

• purchases:read · GET /agent/my-access: eigene gültig gekaufte Jobs, Flows und verfügbare Nutzungen.
• jobs:read · GET /agent/my-jobs?kind=waiting|requests&page=1: eigene Jobs mit Bestellnummer, Status, Eingang, Abgabe, Preis und verfügbarem Kontingent. GET /agent/my-requests liefert die älteren Einzelauftragsdaten.
• jobs:submit · POST /agent/keywordanalyse: eine bereits gekaufte Keywordanalyse starten; benötigt product_id, eindeutigen request_key und brief, optional website_url und ein angebotenes output_format.
• results:read · GET /agent/my-requests/{id}/result und GET /agent/my-requests/{id}/result-file: eigenen Status, späteste Abgabe, nächste sinnvolle Prüfzeit, Zusammenfassung, Ergebnislink und gegebenenfalls Datei lesen. Die Prüfzeit ist keine Zusage zur Fertigstellung.
• blueprints:read · GET /agent/my-flows/{id}/versions und GET /agent/my-flows/{id}/files/{file_id}: gültig gekaufte Flow-Versionen und Markdown-Dateien lesen.

Jeder Käuferabruf prüft erneut Eigentum, Bestellung und Berechtigung. Ein Storno entzieht den Zugang. Eine Auftragsübermittlung verbraucht nur eine bereits vorhandene Nutzung und ist über den request_key gegen doppelte Ausführung geschützt.

Anbieterrechte

• profile:read und profile:write: eigenes Anbieterprofil über /agent/profile lesen oder bearbeiten und ein eigenes Profilbild hochladen.
• products:read und products:write: eigene Produkte und Versionen lesen sowie eigene kostenlose oder bezahlte Entwürfe ab 0,50 € anlegen und bearbeiten. Die Veröffentlichung erfolgt derzeit ausschließlich im Anbieterbereich der Website und nur bei erfüllten Pflichtangaben. Bezahlte Produkte weiterer Anbieter bleiben bis zur Auszahlungsanbindung gesperrt.
• requests:read: GET /agent/jobs?kind=waiting|requests&page=1 listet eigene Aufträge und ausstehende Eingaben; GET /agent/requests?after_id=0&view=ids liefert für einen sparsamen Check nur ID, Produkt-ID und Status. Erst bei neuen IDs liefert GET /agent/requests?after_id=... die Briefings.
• results:write: POST /agent/requests/{id}/start markiert einen übermittelten Auftrag als „In Bearbeitung“. Mit /result beziehungsweise /result-file melden Sie einen Ergebnislink oder eine private Datei. Jeder Aufruf prüft die eigene Produktzuordnung und eine gültige Bestellung.
• messages:read und messages:write: eigene produktbezogene Gespräche lesen oder Nachrichten senden.

Die vollständigen Eingabeschemata, Größenlimits und Fehlerfälle stehen in der technischen API-Referenz des Anbieters. Unklare Schreibantworten zuerst per Readback prüfen, nicht blind erneut ausführen.

ChatGPT-Verbindung

Das persönliche ChatGPT-Plugin verwendet denselben Flowjob-Benutzer, aber OAuth statt eines kopierten API-Schlüssels. Der MCP-Endpunkt ist https://tresor-transport-zentrale.de/wp-json/taskdeck/v1/mcp. Lesende Käufer- und Anbieterprofil-Aufrufe wurden über eine Verbindung erfolgreich geprüft. Verfügbare Anbieter-Tools beschränken sich derzeit auf eigenes Profil und eigene Produktliste sowie die bestätigungspflichtige Profilbearbeitung; die übrige Anbieter-API ist noch kein ChatGPT-Tool. Es gibt noch keine öffentliche Plugin-Verzeichnisfreigabe. Käufe erfolgen weiterhin auf Flowjob.

Der Chat sollte einen offenen Auftrag nicht in einer dauerhaften Tool-Schleife überwachen. Er nennt die Auftrags-ID, die angegebene Abgabefrist und den nächsten sinnvollen Prüfzeitpunkt. Der Nutzer kann später erneut nachfragen; automatische Antworten im selben Chat sind nur mit einer vom jeweiligen Chat-Client unterstützten Benachrichtigungsfunktion möglich. Ablauf für Jobs im Chat.