Berechtigungen

Jeder API-Schlüssel trägt Berechtigungen, und jede seiner Anfragen wird dagegen geprüft. Ein Schlüssel enthält nur, was ihm gegeben wurde: Der Schlüssel in einem Veröffentlichungsskript kann Ihre Rechnungen nicht lesen, und gar kein Schlüssel kann einen weiteren Schlüssel erstellen, jemanden anmelden oder einen anderen Workspace erreichen.

Berechtigungen gibt es pro Bereich in zwei Worten. Schreiben schließt Lesen ein, sodass ein Schlüssel, der etwas ändern darf, es immer auch sehen kann.

Die Bereiche sind genau so gruppiert und geordnet wie das Seitenmenü des Dashboards, sodass die Auswahl auf der Seite und diese Seite sich gleich lesen.

Übersicht

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Beiträge	posts:read	posts:write	Jeder Veröffentlichungsauftrag vom Eintreffen bis zur Veröffentlichung, einschließlich des Abbrechens und Löschens eines Auftrags.
Posts - Approvals	approvals:read	approvals:write	Einen Beitrag freigeben oder ablehnen, der auf eine Person wartet.
Zeitplan	schedule:read	--	Der Veröffentlichungskalender: was zur Veröffentlichung fällig ist und wann.
Compliance	compliance:read	--	Das versiegelte Protokoll von allem, was übergeben, freigegeben und gemeldet wurde, das Prüfen eines Videos dagegen, sein Export für einen Prüfer und das Audit-Protokoll des Workspaces.

Bibliothek

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Clip-Studio	templates:read	templates:write	Die Vorlagen, mit denen ein Clip gerendert werden kann, ihre Varianten und die Formate, in denen sie kommen.
Clip studio - Create clip	renders:read	renders:write	Einen Clip für sich rendern und herunterladen, ohne dass ein Beitrag irgendwohin geht.
Medien	media:read	media:write	Bilder, Video, Sound und Schriften sowie die Clips, die ein Render erzeugt hat.
Media - AI assistant	ai:read	ai:write	Bilder, Videos, Musik, Schriften und Texte mit den KI-Diensten erstellen, die der Workspace verbunden hat, und sie in der Mediathek behalten.

Veröffentlichung

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Marken	brands:read	brands:write	Markendokumente: Namen, Farben, Logos, Disclaimer und der Text, der mit einem Beitrag hinausgeht.
Kanäle	channels:read	channels:write	Die Konten, an die Beiträge gehen, was jedes empfängt, wie seine Beiträge übergeben werden und das Testen seines Plattform-Connectors, dessen Zugangsdaten eine Person mit Verwaltung im Dashboard setzt.
Syndikation	syndication:read	syndication:write	Ihre Syndikationsgruppen und ihre Iframes, die Teilnehmer, die sich angemeldet haben, die Branding- und E-Mail-Einstellungen dessen, was sie sehen, und was jedem gesendet wurde.

Inhaltsquellen

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Fertige Feeds	feeds:read	feeds:write	Die Feeds, die Reelwire mitbringt, und welche davon dieser Workspace verwendet.
Beitragseditor	postlists:read	postlists:write	Geplante manuelle Beiträge: die Listen und die Beiträge, die darin warten.
Eigene Feeds	streams:read	streams:write	Ihre eigenen Datenstreams: sie anlegen, benennen, was sie tragen, und ihre Felder zuordnen.
Custom feeds - Send raw data	--	ingest:write	Ereignisse in Ihre eigenen Feeds einspielen. Das nutzt ein Produzent oder ein Handelssystem.

Verbindungen

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Webhook	webhooks:read	webhooks:write	Wohin Beiträge per Webhook übergeben werden, und eine Testzustellung dorthin.
Aktivität	received:read	--	Was hereinkam: was eintraf, womit es abgeglichen wurde und was es erzeugte oder warum es nichts erzeugte.
Activity - What went out	connections:read	connections:write	Was jede Übergabe gesendet hat, per E-Mail, per Webhook und über den Plattform-Connector, und was zurückkam.

Mein Konto

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Team	team:read	team:write	Die Kollegen in diesem Workspace, was jeder darf, und das Einladen oder Entfernen eines Kollegen.

Abonnement

Bereich	Lesen Sie	Schreiben	Was er abdeckt
Kontingent	allowance:read	--	Wie viele Renders dieser Monat enthält und wie viele übrig sind.
Tarif	plan:read	--	In welchem Tarif dieser Workspace ist und was dieser Tarif einschaltet.

Posts - Approvals wird nur Workspaces angeboten, deren Tarif sie enthält. In jedem anderen Tarif fehlt sie in der Auswahl, und ein Schlüssel kann sie nicht halten.

Compliance wird nur Workspaces angeboten, deren Tarif sie enthält. In jedem anderen Tarif fehlt sie in der Auswahl, und ein Schlüssel kann sie nicht halten.

Syndikation wird nur Workspaces angeboten, deren Tarif sie enthält. In jedem anderen Tarif fehlt sie in der Auswahl, und ein Schlüssel kann sie nicht halten.

Team wird nur Workspaces angeboten, deren Tarif es enthält. In jedem anderen Tarif fehlt es in der Auswahl, und ein Schlüssel kann es nicht halten.

Fertige Sätze

Die Seite bietet diese als Ausgangspunkt an. Es sind gewöhnliche Berechtigungslisten: Wählen Sie eine und schränken Sie sie dann ein.

Rohdaten senden

Für einen Produzenten oder ein Handelssystem, das nur Ereignisse einspielt.

ingest:write

Beiträge erstellen und übergeben

Alles, was nötig ist, um Inhalte zu erstellen, sie zu übergeben und als veröffentlicht zu melden: Beiträge, Beitragslisten, Medien, Renders.

posts:write
postlists:write
media:write
renders:write
templates:read
brands:read
channels:read

Nur lesen

Berichte und Dashboards: sieht alles, was der Workspace hat, ändert nichts.

posts:read
approvals:read
schedule:read
compliance:read
templates:read
renders:read
media:read
ai:read
brands:read
channels:read
syndication:read
feeds:read
postlists:read
streams:read
webhooks:read
received:read
connections:read
team:read
allowance:read
plan:read

Den ganzen Workspace betreiben

Vollständige Konfiguration per Maschine. Sie kann weiterhin keine Schlüssel erstellen oder jemanden anmelden.

posts:read
posts:write
approvals:read
approvals:write
schedule:read
compliance:read
templates:read
templates:write
renders:read
renders:write
media:read
media:write
ai:read
ai:write
brands:read
brands:write
channels:read
channels:write
syndication:read
syndication:write
feeds:read
feeds:write
postlists:read
postlists:write
streams:read
streams:write
ingest:write
webhooks:read
webhooks:write
received:read
connections:read
connections:write
team:read
team:write
allowance:read
plan:read

Wenn ein Schlüssel abgelehnt wird

Eine Anfrage, die ein Schlüssel nicht stellen darf, wird mit 403 und einem Text beantwortet, der die Berechtigung und die Abhilfe nennt, statt einer Scope-Zeichenfolge, die Sie nachschlagen müssten:

{
  "type": "https://reelwire.io/problems/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "This key may not write here. Give it the \"Media: write\" permission, or use a key that has it."
}