Marken

Eine Marke ist das Erscheinungsbild eines Clips: die Farben, die Schriften, das Logo, das Moderatorbild, die Eröffnungs- und Abschlussclips und die Textzeilen, die neben einem Beitrag ausgehen. Jeder Kanal verwendet genau eine Marke, und eine Marke kann von vielen Kanälen verwendet werden. Eine Änderung an einer Marke ändert jeden Clip, der ab jetzt gerendert wird, und berührt keinen bereits gerenderten Clip. Im Dashboard ist das die Seite Marken.

Methode	Pfad	Berechtigung
GET	/v1/brands	brands:read
GET	/v1/brands/{id}	brands:read
GET	/v1/brands/draft	brands:read
POST	/v1/brands	brands:write
PATCH	/v1/brands/{id}	brands:write
POST	/v1/brands/palette	brands:read
POST	/v1/brands/{id}/assets/{slot}	brands:write
POST	/v1/brands/{id}/assets/{slot}/link	brands:write
POST	/v1/brands/{id}/assets/{slot}/delete	brands:write
POST	/v1/brands/{id}/duplicate	brands:write
POST	/v1/brands/{id}/delete	brands:write

Das Stildokument

GET /v1/brands/{id} liefert die Marke mit ihrem gesamten Stildokument.

curl http://localhost:4000/v1/brands/01M1VFRWE7VHP3H54ESRJQ0SAJ \
  -H "Authorization: Bearer rw_your_key_here"

{
  "brand": {
    "id": "01M1VFRWE7VHP3H54ESRJQ0SAJ",
    "name": "Brand 1",
    "enabled": true,
    "style": {
      "identity": {
        "name": "Brand 1",
        "titlePrimary": "Enterprise 2 Brand 1",
        "titleSecondary": "orchid.example",
        "footerPrimary": "Enterprise 2 Brand 1",
        "footerSecondary": "Orchid Invest. Educational only. Not advice."
      },
      "design": { "first": "#120A16", "second": "#1E1226", "third": "#2e2732", "fourth": "#77EE58" },
      "accent": { "positive": "#77EE58", "negative": "#E8527F" },
      "text": {
        "primary": { "font": "open-sans", "size": 1, "color": "#F6EEFA" },
        "secondary": { "font": "open-sans", "size": 1, "color": "#A990B5" }
      },
      "logo": {
        "assetId": "01M2S2CPNV2YKF8VRV9396BYRD",
        "fileName": "logo.png",
        "mimeType": "image/png",
        "url": "http://localhost:4000/v1/assets/01M2S2CPNV2YKF8VRV9396BYRD/download?exp=1789722057&sig=2af0b0a171347dad96f961ed99f44862050dfa2c678f0566f12a7f56392319c5"
      },
      "badge": {
        "kind": "image",
        "enabled": true,
        "primaryLine": "Alex Fischer",
        "secondaryLine": "Head of markets",
        "asset": { "assetId": "01M2S2CP6YVZQX9BPE68FXSP5Y", "fileName": "badge.png", "mimeType": "image/png", "url": "..." }
      },
      "background": { "kind": "color" },
      "sound": {
        "mode": "clip-outro",
        "asset": { "assetId": "01M2S2CPB4XJ7K0N2QH3RZ5TWE", "fileName": "jingle.mp3", "mimeType": "audio/mpeg", "url": "..." }
      },
      "posting": {
        "description": "Orchid Invest shares short market updates. Educational only, not advice.",
        "hashtags": ["orchidinvest"],
        "link": { "url": "https://orchid.example", "label": "Visit our website" }
      },
      "safeAreas": {
        "16x9": { "top": 64, "right": 96, "bottom": 72, "left": 96 },
        "9x16": { "top": 96, "right": 72, "bottom": 240, "left": 72 }
      }
    }
  }
}

Die Teile des Dokuments:

Teil	Was es ist
identity	Der eigene name der Marke, der nie angezeigt wird, und die vier Zeilen, die eine Vorlage zeigt: titlePrimary und titleSecondary oben, footerPrimary und footerSecondary unten (Texte im Clip im Dialog der Marke). Der Name und titlePrimary umfassen bis zu 80 Zeichen, titleSecondary 120, footerPrimary 160 und footerSecondary 400.
palette, design, accent	Die Farben. Wo palette gesetzt ist (dieselben Felder wie bei /v1/brands/palette), werden die vier design-Farben, die zwei accent-Farben und die Farben der Textrollen bei jedem Speichern daraus berechnet; die Schriften und Größen bleiben wie eingestellt.
text	primary (Überschriften) und secondary (Fließtext), jeweils mit font, einer size von 0,5 bis 3,5 und einer color; tertiary, für ältere Marken weiterhin akzeptiert, aber von nichts angezeigt (die kleinsten Zeilen verwenden die secondary-Farbe); und frame, die Schrift und Größe der oberen und unteren Zeile. Eine Rolle kann eine eigene Schriftdatei file der Marke tragen, die gegenüber ihrer font bevorzugt wird.
logo, badge, background, stinger, intro, outro	Die Dateien, befüllt über die Plätze unten. Das Moderatorbild hat einen Schalter enabled (fehlt er, ist es an) und fügt zwei Textzeilen hinzu, primaryLine (bis zu 48 Zeichen) und secondaryLine (bis zu 64), die als Namenskarte angezeigt werden. Ein background hat die kind color (mit einer color), image oder video, ebenfalls mit einem Schalter enabled (fehlt er, ist er an; aus zeigt die erste Designfarbe); ohne einen ist die erste Designfarbe der Untergrund. stinger, intro und outro haben jeweils enabled, clips je Seitenverhältnis und einen universellen Clip asset (siehe die Plätze unten); ein fertiger Clip spielt Stinger, Intro, den Clip, Outro. made bei diesen dreien und bei einem background hält fest, wie Mit Reelwire eines erstellen im Dashboard den Film erstellt hat (seine Vorlage, sein Stil und sein Inhalt), damit der Dialog wieder darauf öffnet; nichts zeigt es an.
sound	Ein Soundtrack über dem fertigen Clip, mit mode: none, clip, clip-stinger, clip-intro, clip-outro, clip-stinger-intro, clip-stinger-outro, clip-intro-outro oder clip-stinger-intro-outro; er nennt die Teile, über denen er neben dem Clip spielt.
header	Die obere Zeile der Format-Vorlagen, { "enabled": false }, um sie in jedem Clip wegzulassen: das Logo, die Titelzeile und die Dekoration des Stils darum herum; der Inhalt beginnt dann ganz oben. Fehlt sie, ist sie an. Ein einzelner Clip lässt sie mit hideHeader in seinem look weg; Intros, Outros, Stinger und Overlays zeigen immer das Logo.
footer	Die Fußzeile der Format-Vorlagen, { "enabled": false }, um sie in jedem Clip wegzulassen: die Fußzeile der Marke (identity.footerPrimary und footerSecondary, unverändert gespeichert) und alles, was der Stil nur zu ihrer Aufnahme zeigt. Fehlt sie, ist sie an. Ein einzelner Clip lässt sie mit hideFooter in seinem look weg; der Moderator und die Quellenzeile bleiben.
safeAreas	Je Seitenverhältnis, wie weit von jedem Rand (top, right, bottom, left, in Pixeln) eine Vorlage ihren Inhalt hält, frei von dem, was eine Plattform über ein Video legt.
posting	Was neben jedem Beitrag ausgeht, nie im Clip: eine description (als disclaimer des Beitrags gesendet), hashtags, die zu denen des Beitrags hinzukommen, und ein link (Beitragstext im Dialog der Marke). Zusammen dürfen sie höchstens 300 Zeichen umfassen, damit jeder Beitrag Platz für sein Eigenes behält.
locales	Dieselbe Marke in einer anderen Sprache, nach Sprachcode: nur das, was diese Sprache anders sagt, etwa eigene Zeilen, Farben, Beitragstexte oder Dateien. Alles, was sie auslässt, ist das der Standardsprache. Der Name der Marke und ihr Soundtrack sind in jeder Sprache gleich.

font ist eine der Schriften, die der Renderer mitbringt: open-sans (der Standard), bebas-neue, dm-sans, inter, lato, lora, montserrat, nunito, oswald, playfair-display, poppins, pt-serif, raleway, roboto, roboto-mono, roboto-slab, rubik, source-sans-3, work-sans, liberation-sans, liberation-serif oder liberation-mono. Jede andere Schrift ist eine eigene Schriftdatei der Marke in einem der Schriftplätze unten.

Die 300 Zeichen von posting werden so gezählt, wie ein Beitrag sie trägt, die Leerzeile vor jedem Teil eingeschlossen, und der eigene Beitragstext jeder Sprache unterliegt demselben Limit. Ein Beitrag trägt dann die längste Länge seiner Beschreibung, die innerhalb des Limits seiner Plattform diese 300 Zeichen noch frei lässt. Ein Speichern über dem Limit ist ein 400, der sagt, wie viele Zeichen der Text umfasst. Eine Link-Beschriftung ohne Adresse wird verworfen statt abgelehnt, und eine Adresse muss eine vollständige Webadresse sein, etwa https://www.example.com.

GET /v1/brands liefert jede Marke mit einer abgeflachten summary statt des ganzen Dokuments, dazu die Kanäle, die sie verwenden. Lesen Sie die Liste, um eine Marke zu finden, und lesen Sie eine Marke, um sie zu bearbeiten. Dateiadressen in einer mit GET /v1/brands/{id} gelesenen Marke sind signierte Vorschauen, bei jedem Lesen neu erzeugt und eine Stunde gültig; gespeichert wird von der Marke die ID der Datei.

Eine neue Marke ansehen, bevor Sie sie erstellen

GET /v1/brands/draft stellt genau das zusammen, was das Erstellen zusammengestellt hätte, und speichert nichts. So zeigt der Dialog Marke hinzufügen auf Marken ein echtes Dokument, solange der Workspace diese Marke noch nicht hat.

curl http://localhost:4000/v1/brands/draft \
  -H "Authorization: Bearer rw_your_key_here"

{
  "name": "New brand",
  "style": {
    "identity": {},
    "design": { "first": "#120A16", "second": "#1E1226", "third": "#2e2732", "fourth": "#E0A52E" },
    "accent": { "positive": "#E0A52E", "negative": "#E8527F" },
    "text": {
      "primary": { "font": "open-sans", "size": 1, "color": "#F6EEFA" },
      "secondary": { "font": "open-sans", "size": 1, "color": "#A990B5" }
    },
    "safeAreas": {
      "16x9": { "top": 64, "right": 96, "bottom": 72, "left": 96 },
      "9x16": { "top": 96, "right": 72, "bottom": 240, "left": 72 }
    }
  }
}

name ist der erste freie Name im Workspace. identity kommt absichtlich leer zurück: Ein Formular mit „Neue Marke 6“ schon darin ist ein Formular, dessen bequemer Weg den Platzhalter einer Maschine in einem Clip veröffentlicht.

Eine Marke erstellen

curl http://localhost:4000/v1/brands \
  -H "Authorization: Bearer rw_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Orchid Invest DE"}'

201, mit der Marke als { "brand": { ... } }. name und style sind beide optional. Ohne Namen nimmt Reelwire den ersten freien. Ohne Stil stellt es dasselbe Startdokument zusammen, das /v1/brands/draft zeigt, mit aus dem Namen gefüllter Identität statt einer leeren, denn ein Erstellen ohne Oberfläche hat niemanden, der sie tippt. Eine neue Marke übernimmt die Farben und die Schrift der neuesten Marke, nie ihre Dateien (Schriftdateien und Soundtrack eingeschlossen), ihre Identität, ihren Beitragstext oder ihre Sprachen. Ein bereits verwendeter Name ist ein 409, ebenso eine neue Marke über der Zahl, die ein Workspace halten darf (200, sofern Reelwire dafür kein anderes Limit gesetzt hat).

Die Default brand

Jeder neue Workspace beginnt mit einer Marke, Default brand, die sein Default channel verwendet. Ihre obere Zeile und Fußzeile tragen ihren eigenen Namen, sie hat die Standardfarben und die Standardschrift, einen Beitragstext, der erkennbar ein Beispiel zum Ersetzen ist, und die Startdateien, die ihre Mediathek mitbrachte, in ihre Plätze eingebunden: das Logo, ein Moderatorbild mit den Zeilen „John Doe“ und „Presenter“, ein universelles Hintergrundbild (background.asset), eine Überschriftenschrift (Bebas Neue) und einen Soundtrack über dem Clip und allen eingeschalteten von Stinger, Intro und Outro. Sie enthält außerdem einen Stinger, ein Intro und ein Outro, je einen universellen Clip als asset und keinen Clip für irgendein Bildformat, jeweils mit enabled false, sodass ein Kunde nur noch eines einzuschalten braucht. Sie ist eine gewöhnliche Marke: Bearbeiten Sie sie, oder erstellen Sie eine eigene und stellen Sie den Kanal darauf um.

Eine Marke ändern

PATCH /v1/brands/{id} nimmt name, enabled und style entgegen. Ein Stil wird als Ganzes gegen den Vertrag geprüft, und eine Ablehnung ist ein 400 mit einem Verweis unter /style für jedes Problem. Ein name, den eine andere Marke hat, ist ein 409.

Die Dateien in einem Stil, den Sie senden, werden größtenteils ignoriert. Das Logo, das Moderatorbild, die Hintergrunddateien und die Clips für Stinger, Intro und Outro werden aus dem Gespeicherten gelesen, nicht aus Ihrem Text. Eine Datei wird über einen Platz angehängt, sodass ein Dokument eines veralteten Clients keine Referenz einführen kann, die der Speicher nicht hält, und ein weggelassenes Moderatorbild, Stinger, Intro oder Outro behält, was gespeichert ist. Was Ihr Text steuert, ist alles um diese Dateien herum: die beiden Zeilen des Moderatorbilds, seine kind und sein Schalter enabled, die Schalter enabled von Stinger, Intro und Outro und ihr made sowie der background. Ein Hintergrund mit kind: "color" wird so übernommen, wie Sie ihn senden; einer mit kind image oder video behält die gespeicherten Dateien, die jeweils eigene jedes Bildformats, und übernimmt sein enabled und made aus Ihrem Text; und ein Stil ganz ohne background speichert die Marke ohne einen.

Drei Teile werden so übernommen, wie Sie sie senden: die Schriftdateien unter text, der sound und die locales. Senden Sie sie so zurück, wie GET sie Ihnen gegeben hat, sonst entfernt das Speichern sie.

Was ein Dokument auch nennt, angezeigt werden nur Dateien, die Reelwire hält: eine in die Marke hochgeladene Datei oder eine aus der Mediathek. Eine Referenz auf irgendetwas anderes wird als nichts angezeigt.

Der eigene Name der Marke im Stil und der Name in der Liste folgen einander: Wer style.identity.name setzt, benennt auch den Datensatz um, es sei denn, eine andere Marke hat diesen Namen schon; dann behält der Datensatz seinen alten, und das Speichern gelingt trotzdem. Es ist der Name, unter dem die Marke im Dashboard und in GET /v1/brands bekannt ist; nichts zeigt ihn in einem Clip, in dem die vier Zeilen das sind, was ein Zuschauer liest.

Eine Palette ableiten

POST /v1/brands/palette berechnet aus einer Markenfarbe eine ganze Palette und prüft ihren Kontrast. Es speichert nichts, Sie können es also aufrufen, während jemand eine Farbauswahl zieht, und ein Schlüssel, der Marken nur lesen darf, darf es aufrufen: Es ist ein POST, weil die Frage ein Dokument ist, nicht weil es etwas ändert.

curl http://localhost:4000/v1/brands/palette \
  -H "Authorization: Bearer rw_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"stage":"dark","brand":"#77EE58","direction":"green-up"}'

{
  "palette": {
    "stage": "#0E100D",
    "surface": "#1C1F1B",
    "surfaceRaised": "#2A2C28",
    "line": "#383C36",
    "lineStrong": "#525750",
    "textStrong": "#F7F9F6",
    "textBody": "#E3E5E2",
    "textMuted": "#9D9F9C",
    "onBrand": "#0B0B0C",
    "onPositive": "#0B0B0C",
    "onNegative": "#0B0B0C",
    "brand": "#77EE58",
    "brandMuted": "#21301D",
    "brandSecond": "#B2CFFE",
    "positive": "#3FB950",
    "negative": "#E5534B",
    "neutral": "#848882",
    "series": ["#77EE58", "#B2CFFE", "#29B2EE", "#787AD8", "#D383D1", "#CC5E6B"]
  },
  "checks": [
    { "label": "Headline on the stage", "ratio": 18.1, "target": 7, "ok": true },
    { "label": "Headline on a card", "ratio": 15.7, "target": 7, "ok": true },
    { "label": "Body text on a card", "ratio": 13.1, "target": 7, "ok": true },
    { "label": "Labels on a card", "ratio": 6.2, "target": 4.5, "ok": true },
    { "label": "Brand colour on the stage", "ratio": 12.9, "target": 3, "ok": true },
    { "label": "Rise on the stage", "ratio": 7.5, "target": 3, "ok": true },
    { "label": "Fall on the stage", "ratio": 5.2, "target": 3, "ok": true },
    { "label": "Text on a brand fill", "ratio": 13.3, "target": 7, "ok": true }
  ]
}

Der Text:

Feld	Erforderlich	Was es ist
brand	ja	Die eine Farbe, die einen Clip zu ihrem macht, als Hex-String.
stage	nein	dark oder light. Standard ist dark.
background	nein	Der Untergrund. Fehlt er, ist es ein fast schwarzer oder fast weißer Ton mit einer Spur vom Farbton der Marke.
direction	nein	Welche Farben für Aufwärts und Abwärts stehen: green-up, red-up, blue-up oder custom. Standard ist green-up.
positive, negative	nein	Nur mit direction: "custom".
second	nein	Die zweite Farbe, wo zwei Dinge verglichen werden.
overrides	nein	Einzelne Farben, von Hand festgelegt.

brand ist erforderlich, und ein Text ohne sie ist ein 400, der /palette/brand nennt.

Dateien der Marke

Die Dateien einer Marke kommen in benannte Plätze, eine Datei je Platz, hochgeladen als multipart/form-data genau so, wie die Mediathek eine entgegennimmt. Ein Platz hält eine Sache, sodass die zuvor hochgeladene Datei gelöscht wird, es sei denn, ein anderer Platz der Marke verwendet sie noch; eine Mediathek-Datei, die dort verknüpft war, bleibt in der Mediathek. Die Dateien einer Marke zählen zusammen mit der Mediathek gegen den Medienanteil des Speichers des Workspaces: Eine Datei, die nicht passt, ist ein 429, der sagt, wie viel Platz noch ist. Eine Marke hält höchstens 100 hochgeladene Dateien (sofern Reelwire kein anderes Limit gesetzt hat), und darüber ist ein Upload ein 409.

Platz	Nimmt	Limit
logo	PNG, JPEG, WebP, SVG	5 MB
background, background-{ratio}	PNG, JPEG, WebP, MP4, WebM	50 MB
badge	PNG, JPEG, WebP, MP4, WebM	20 MB
sound	MP3, WAV	20 MB
stinger, intro, outro, stinger-{ratio}, intro-{ratio}, outro-{ratio}	MP4, WebM	50 MB
font-primary, font-secondary, font-tertiary, font-frame	WOFF2, WOFF, TTF, OTF	10 MB

curl http://localhost:4000/v1/brands/01M1VFRWE7VHP3H54ESRJQ0SAJ/assets/logo \
  -H "Authorization: Bearer rw_your_key_here" \
  -F "file=@logo.png;type=image/png"

{
  "slot": "logo",
  "asset": {
    "assetId": "01M2SRB6Q0Y4ZT5N8X2KDM7HCE",
    "url": "http://localhost:4000/v1/assets/01M2SRB6Q0Y4ZT5N8X2KDM7HCE/download?exp=...&sig=...",
    "mimeType": "image/png",
    "fileName": "logo.png"
  }
}

201. Ein Clip, der in einen Platz für Stinger, Intro oder Outro gelegt wird, schaltet diese Seite ein, und eine Sounddatei, die eingelegt wird, während der Soundtrack aus ist, schaltet ihn über dem Clip ein. Ein Platzname, den Reelwire nicht kennt, ist ein 404; eine Datei eines Typs, den der Platz nicht nimmt, oder eine locale, die kein unterstützter Sprachcode ist, ist ein 400.

Stinger, Intro, Outro und Hintergrund haben je einen Platz je Seitenverhältnis: stinger-1x1, intro-9x16, outro-16x9, background-16x9, und einen universellen Platz, stinger-universal, intro-universal, outro-universal und background-universal. Ein Render nimmt die Datei seines eigenen Bildformats; für ein Bildformat ohne eine die universelle Datei; und nie die eines anderen Bildformats, sodass ein Bildformat mit keiner von beiden keinen Clip zeigt und ein Hintergrund auf der ersten Designfarbe erscheint. Eine universelle Datei wird auf die Bildfläche skaliert und von der Mitte aus beschnitten; erstellen Sie sie also mit der Hauptaktion in der Mitte und Spielraum an den Rändern. Die Dateien je Bildformat sind die clips jedes Satzes (background.assets), nach Seitenverhältnis benannt, und die universelle Datei ist sein asset (background.asset).

Die Plätze ohne Suffix, stinger, intro, outro und background, werden mit einem 400 abgelehnt, der die stattdessen zu sendenden Plätze nennt (seit dem 10.10.2026, als der alte Standard zurückgezogen wurde; der universelle Platz ist das, was daraus wurde).

Schriften und Sound sind nicht sprachabhängig: Eine Marke ist in ihrer Schrift gesetzt und klingt in jeder Sprache gleich. Das Logo, der Hintergrund, das Moderatorbild und die Clips können es sein, mit ?locale=de beim Upload, beim Verknüpfen oder beim Löschen; die Datei landet dann im Overlay dieser Sprache statt in der Standardsprache der Marke.

font-tertiary wird weiterhin akzeptiert, für Marken, die eine erhalten haben, aber nichts wird damit angezeigt: Die kleinsten Zeilen sind in der Schrift des Fließtexts gesetzt, font-secondary.

Die Referenz wird beim Upload in das gespeicherte Dokument geschrieben statt einem späteren Speichern überlassen, sodass es nie eine Datei gibt, die der Speicher hält und auf die nichts zeigt.

POST /v1/brands/{id}/assets/{slot}/link verweist einen Platz auf eine Datei, die schon in der Mediathek ist, mit { "url": "media://{id}" }, statt eine zweite Kopie hochzuladen. Akzeptiert wird nur eine Mediathek-Datei dieses Workspaces, benannt über ihre ID und von einem Typ, den der Platz nimmt: Eine Marke verweist nie auf eine Datei auf dem Server eines anderen. Alles außer media:// und einer ID, auch ein Dateiname, ist ein 400, eine ID, die die Mediathek nicht hält, ist ein 404, und eine Datei eines Typs, den der Platz nicht nimmt, ist ein 400. Es antwortet mit dem Platz und der Referenz, wie ein Upload, und eine Clip- oder Sounddatei schaltet auch hier ihre Seite ein.

POST /v1/brands/{id}/assets/{slot}/delete leert den Platz und antwortet mit { "slot": "...", "asset": null }, auch wenn der Platz schon leer war. Eine in den Platz hochgeladene Datei wird mit ihm gelöscht, es sei denn, ein anderer Platz der Marke verwendet sie noch; eine verknüpfte Mediathek-Datei bleibt in der Mediathek. Das Leeren von sound schaltet den Soundtrack aus.

Eine Website auf ihre Marke hin lesen

POST /v1/brands/read-website mit { "url": "beckers-garage.example" } liest eine öffentliche Seite, die eigene Website eines Unternehmens, und antwortet mit website: woraus eine Marke besteht, damit ein Assistent daraus eine Marke vorschlagen kann.

Feld	Was es ist
logos	Logo-Kandidaten als Adressen, zuerst die strukturierten Daten des Unternehmens, dann Bilder, die die Seite als Logo bezeichnet. Übernehmen Sie eines mit POST /v1/media/import.
inlineSvgLogo	Die Seite zeigt ihr Logo inline als SVG, das keine Adresse hat: Verlangen Sie stattdessen die Datei.
colours, neutrals, themeColour	Die Farben, die ihre Stile am häufigsten verwenden, gewichtet zugunsten derer, die sie als die ihrer Marke nennt, Grautöne, Weiß und Schwarz ausgenommen.
fonts	Die Schriften, die ihre Font-Links und Stile nennen.
socials	Ihre Social-Media-Profile, aufgelistet und nicht gelesen: Diese beantworten einen Server mit einer Anmeldeseite.
business	Ihre eigenen Angaben, wo sie sie macht: name, type, telephone, email, address, openingHours.
title, description, menu, headings, paragraphs	Ihre eigenen Worte.

Nichts wird gespeichert. Die Seite wird so abgerufen, wie ein Medienimport abgerufen wird: nur HTTPS (eine ohne eines eingegebene Adresse wird über HTTPS angefragt), nie eine interne Adresse, Weiterleitungen geprüft, höchstens 3 MB, mit bis zu drei ihrer eigenen Stylesheets. Alles in der Antwort ist der Text der Website, und der MCP-Server übergibt ihn einem Assistenten als Fremdtext gekennzeichnet. Es braucht Brands: read, und ein Workspace darf dreißig Websites pro Stunde lesen.

Eine Marke duplizieren

POST /v1/brands/{id}/duplicate mit { "name": "Northwind DE" } erstellt eine zweite Marke wie diese und antwortet mit 201 und ihr, wie das Erstellen. Alles wird kopiert: das ganze Stildokument, jede Sprache darin und enabled. Der angegebene Name ist der eigene der Kopie, als name und als identity.name, sodass die Liste und die Einstellungen der Kopie übereinstimmen. Er ist erforderlich, und ein Name, den eine andere Marke hat, ist ein 409.

In die Marke hochgeladene Dateien werden kopiert, sodass die Plätze der Kopie eigene Dateien mit neuen IDs halten und die Bytes ein zweites Mal gegen das Speicherkontingent zählen (ein 429, wenn kein Platz ist, und nichts wird erstellt). Dateien aus der Mediathek (media://-Referenzen) werden nicht kopiert: Beide Marken verweisen auf dieselbe Mediathek-Datei, wie wenn zwei Marken sie wählen. Erfordert Brands: write.

Eine Marke löschen

Jeder Kanal verwendet eine Marke, daher ist POST /v1/brands/{id}/delete bei einer Marke in Verwendung ein 409, dessen Meldung die Zahl nennt: „Brand 1 is used by 5 channels. Choose the brand they use instead.“

Senden Sie { "moveTo": "{another brand id}" }, und die Kanäle werden im selben Schritt auf diese Marke umgestellt; ein moveTo, das keine andere Marke des Workspaces nennt, ist ein 404. Das Array channels bei GET /v1/brands sagt Ihnen vorab, wie viele es sind. Die Antwort ist { "deleted": "...", "moved": 5 }. Eine entfernte Marke verschwindet aus der Liste, aber nicht aus der Historie: Clips, die sie schon gerendert hat, behalten ihr Erscheinungsbild, und ihr Name bekommt „ (removed)“ angehängt, sodass eine neue Marke ihn übernehmen kann.

Häufige Fehler

Dateireferenzen in einem style-PATCH senden. Das Logo, das Moderatorbild, der Hintergrund und die Clips werden ignoriert und wurden es immer. Laden Sie in den Platz hoch, oder verknüpfen Sie eine Mediathek-Datei damit.

Die Schriftdateien unter text, sound oder locales in einem style-PATCH weglassen. Diese werden so übernommen, wie sie gesendet werden; ein Dokument ohne sie speichert also eine Marke ohne ihre Schriftdateien, ihren Soundtrack oder ihre Sprachen.

background in einem style-PATCH weglassen. Die Marke wird ohne Hintergrund gespeichert, Bild oder Video eingeschlossen. Senden Sie ihn so zurück, wie GET ihn Ihnen gegeben hat.

Einen Intro-Clip hochladen und erwarten, dass er überall passt. Er wird überall verwendet, in den anderen Bildformaten auf Schwarz eingepasst: Ein 9x16-Kanal, für den nur intro oder intro-16x9 hochgeladen wurde, beginnt mit einem Clip mit schwarzen Balken. Laden Sie intro-9x16 für einen Clip hoch, der die Bildfläche füllt.

Eine Marke bearbeiten, um einen Kanal zu ändern. Jeder Kanal, der sie verwendet, ändert sich. Erstellen Sie eine zweite Marke.

Erwarten, dass /v1/brands/palette eine Marke ändert. Es antwortet nur. Eine Marke übernimmt die Farben, wenn dieselben Felder mit einem PATCH als ihre style.palette gespeichert werden, was ihre design-, accent- und Textfarben daraus berechnet.

Eine Marke ohne moveTo löschen. Jedes Mal ein 409, der die Zahl der Kanäle nennt.