Referenz · VOR API 2.5.43

Alle Operationen

84 Operationen auf 72 Endpunkten, gelesen aus der Live-Spezifikation. Basisadresse: https://your-domain.com. Parameter, Request-Bodys und Antworten stehen in openapi.json.

Inhalt und Revisionen

Entwürfe erstellen, Sprachversionen als unveränderliche Revisionen schreiben, vor dem Veröffentlichen prüfen, kommentieren und vergleichen.

GET/studio/api/kandisEine Person in den Prominentendaten der Website nachschlagen – Kurzfakten für Interviews
GET/studio/api/innehallDie Inhaltsliste – nach Ressort und Status filtern oder veraltete und fehlende Übersetzungen finden
POST/studio/api/innehallInhalt anlegen (einen Entwurf). Idempotent mit Idempotency-Key.
GET/studio/api/innehall/{id}Der Inhalt mit allen Sprachversionen und Arbeitsrevisionen
PATCH/studio/api/innehall/{id}Ressort, Vorlage, Tags, Kategorien, Sponsoring, Quellen, Eigentümer, Überschrift, Status oder Löschung ändern
PUT/studio/api/innehall/{id}/sprak/{sprak}Eine Sprachversion einreichen – eine neue, unveränderliche Revision. 409 bei Konflikt.
POST/studio/api/innehall/{id}/sprak/{sprak}/statusDen Status einer Sprache setzen: Entwurf, Prüfung, freigegeben oder Aktualisierung nötig
GET/studio/api/innehall/{id}/sprak/{sprak}/revisionerDer Revisionsverlauf
POST/studio/api/innehall/{id}/sprak/{sprak}/aterstallEine frühere Revision wiederherstellen (sie wird zu einer neuen Revision)
GET/studio/api/svep/faktarutaReiner Lesedurchlauf: veröffentlichte Artikel, deren Faktenkasten leer ist. Nichts wird geändert.
POST/studio/api/innehall/{id}/forslagVorschläge zur Auswahl: SEO-Analyse und Titel, Tags und Kategorien, weiterführende Lektüre, Hero-Alt-Text, Promotexte
POST/studio/api/innehall/{id}/kopieraIn einen neuen Entwurf kopieren (gleiches Ressort, gleiche Vorlage, Tags und Kategorien)
POST/studio/api/innehall/{id}/valideraDie Prüfung vor der Veröffentlichung: blockierende Fehler und unverbindliche Warnungen pro Sprache
GET/studio/api/dubbletterDie Duplikatprüfung: Zeilen, die eine WordPress-ID oder eine Adresse teilen
GET/studio/api/innehall/{id}/revision/{rid}Eine Revision in beliebiger Sprache – für den Vergleich Block für Block
GET/studio/api/innehall/{id}/kommentarerInterne Kommentare
POST/studio/api/innehall/{id}/kommentarerEin neuer interner Kommentar an die Redaktion
PATCH/studio/api/innehall/{id}/kommentarer/{kid}Einen Kommentar als erledigt oder unerledigt markieren
POST/studio/api/innehall/{id}/lasEine weiche Bearbeitungssperre pro Sprache für 90 Sekunden – echte Konflikte regeln die Revisionen
GET/studio/api/innehall/{id}/loggDas Protokoll des Inhalts – wer wann was getan hat, inklusive Veröffentlichungen

Vorschau und Veröffentlichung

Vorschau mit dem eigenen Rendering der Website, zeitlich begrenzte Links teilen, jetzt oder nach Zeitplan veröffentlichen und jede Veröffentlichung verfolgen.

GET/studio/live/{id}.jsonDie Beiträge eines Live-Berichts als JSON – öffentlich und ohne Anmeldung, nur veröffentlichter Inhalt, 20 Sekunden lang gecacht
POST/studio/api/innehall/{id}/nedtagningEinen veröffentlichten Artikel zurückziehen (nur Redaktion – Agenten erhalten 403)
POST/studio/api/innehall/{id}/forhandsvisningVorschau mit dem eigenen Rendering der Website; dela=minutes liefert einen zeitlich begrenzten, widerrufbaren Link
POST/studio/api/innehall/{id}/releaseVeröffentlichung: feste Revisionen für gewählte Sprachen – Entwurf, sofort veröffentlichen oder geplant, in der Zeitzone des Verlags
GET/studio/api/release/{id}Status und Ergebnis einer Veröffentlichung
POST/studio/api/release/{id}/avbrytEine geplante Veröffentlichung abbrechen
GET/studio/api/releaserDer Kalender: Veröffentlichungen innerhalb eines Zeitraums
GET/studio/api/utkastWartet auf Ihr Ja: außerhalb von Studio geschriebene Entwürfe und Studio-Inhalte in der Prüfung
POST/studio/api/utkast/{id}/publiceraEinen von VOR geschriebenen Entwurf sofort veröffentlichen oder planen – erfordert Veröffentlichungsrechte
POST/studio/api/utkast/{id}/avfardaEinen Entwurf ablehnen (in WordPress wird nichts gelöscht) – erfordert Veröffentlichungsrechte
POST/studio/api/utkast/{id}/forhandsvisningVorschau auf Schwedisch und Englisch in der eigenen Vorlage der Website
GET/studio/api/innehall/{id}/releaserDie Veröffentlichungen des Inhalts
GET/studio/api/innehall/{id}/delningarGeteilte Vorschauen
DELETE/studio/api/innehall/{id}/delningar/{token}Eine geteilte Vorschau widerrufen
POST/studio/api/release/{id}/korEine geplante oder fehlgeschlagene Veröffentlichung jetzt ausführen (Veröffentlichungsberechtigte)

Übersetzung und Jobs

KI-Übersetzung als Entwürfe – ein Artikel oder sechzig auf einmal – mit abfragbarem Job-Status.

POST/studio/api/innehall/{id}/oversattEinen Übersetzungsentwurf mit dem KI-Adapter erstellen (ein Job). Für eine manuelle Übersetzung die Sprachversion per PUT einreichen.
POST/studio/api/oversatt-listaBis zu 60 Artikel in einem Durchlauf neu übersetzen – ein Job pro Artikel, als Entwürfe gespeichert, nichts veröffentlicht
GET/studio/api/oversatt-listaStatus der Übersetzungsjobs – alle 5–10 Sekunden abfragen, bis sie fertig sind
GET/studio/api/jobb/{id}Jobstatus (Übersetzung und mehr)
GET/studio/api/jobbDie Jobliste (die letzten 100)

Medienbibliothek

Bilder hochladen, Credits und Rechte festhalten, Alt-Text pro Sprache schreiben und sehen, wo jedes Bild verwendet wird.

GET/studio/api/mediaDie Medienbibliothek (Suche, Seite)
POST/studio/api/mediaEin Bild hochladen – per https-Adresse oder als Rohbytes (JPEG, PNG, WebP oder GIF bis 40 MB) mit Credit und Rechten
GET/studio/api/media/wpDie WordPress-Medienbibliothek nach Bildern durchsuchen, die bereits auf der Website sind
POST/studio/api/media/wpEin WordPress-Bild in Studio registrieren – kein neuer Upload
GET/studio/api/media/{id}Ein Medienelement mit seinen Texten
PATCH/studio/api/media/{id}Rechte: Fotograf, Quelle, Credit, Lizenztyp, gültig bis, Einschränkungen, geprüft
PUT/studio/api/media/{id}/text/{sprak}Alt-Text und Bildunterschrift pro Sprache (und pro Verwendung)
GET/studio/api/media/{id}/anvandningWo das Bild verwendet wird
PUT/studio/api/media/{id}/filDie Datei eines Bildes ersetzen, aber seine Adresse behalten – alles, was darauf verweist, zeigt das neue Bild

Tags, Kategorien und Personen

Tags vorschlagen und setzen, Tags für Namen anlegen und das Personenverzeichnis der Website lesen.

GET/studio/api/taggarTags: Status, die hundert größten Tags, Artikel ohne Tag
GET/studio/api/kategorierKategorien aus WordPress
POST/studio/api/taggar/forslagBis zu vier Tags für einen Artikel aus den vorhandenen Tags vorschlagen
POST/studio/api/taggar/sattTags an einem Artikel setzen und den Suchindex aktualisieren – erfordert Veröffentlichungsrechte
GET/studio/api/ordbokWörterbuch und Personen: die am häufigsten beschriebenen Personen, Namen ohne Tag, die häufigsten Wörter
POST/studio/api/ordbok/taggEinen Tag für einen Namen ohne Tag anlegen – erfordert Veröffentlichungsrechte

Aufträge und Ideen

Die gemeinsame Warteschlange von Redakteuren und Agenten und die Ideen aus der Medienbeobachtung.

GET/studio/api/uppdragDie Auftragswarteschlange: wartet auf Prüfung, offen, erledigt und abgelehnt
POST/studio/api/uppdragEin neuer Auftrag an VOR {text, section, priority}
POST/studio/api/uppdrag/{id}/{atgard}Einen Auftrag genehmigen, zurücksenden oder ablehnen – erfordert Veröffentlichungsrechte
GET/studio/api/forslagvyIdeen: Geschäftschancen, redaktionelle Blickwinkel, Google Trends, Aufträge, Kampagnen zur Auswahl, Quellen
POST/studio/api/forslag/{id}/bestallEine Idee in Auftrag geben – sie wird zu einem Auftrag in Ihrem Namen
POST/studio/api/forslag/{id}/angraEinen Auftrag oder eine Ablehnung rückgängig machen
POST/studio/api/forslag/kampanj/{id}/plockEine Shopping-Edit-Liste aus einer Kampagne in Auftrag geben – ein Auftrag in Ihrem Namen
POST/studio/api/forslag/byggNeue Ideen aus der Medienbeobachtung holen – erfordert Veröffentlichungsrechte

Commerce-Links

Der Linkmonitor und die ausgehenden Links der Website zu Affiliate-Programmen.

GET/studio/api/kop/lankvaktDer Linkwächter: defekte Kauflinks, Links ohne Artikel-ID, Seiten, die nicht antworten
GET/studio/api/utlankarAusgehende Links: interne /ut/-Pfade, die die Website an Affiliate-Programme weiterleitet
PUT/studio/api/utlankarEinen oder mehrere ausgehende Links registrieren
DELETE/studio/api/utlankar/ut/{grupp}/{id}Einen ausgehenden Link entfernen

Konto, Regeln und Administration

Wer Sie sind, das Redaktionshandbuch, Vorlagen und Ressorts – und, für Administratoren, Agenten, Rollen, Einstellungen, Protokoll und Export.

GET/studio/api/jagWer bin ich – Rolle, Ressorts, Sprachen und Rechte
GET/studio/api/handbokDas Redaktionshandbuch – die Regeln für alles, was in Studio geschrieben wird. Lesen Sie es zu Beginn jeder Sitzung.
GET/studio/api/sektionerRessorts mit ihren kompatiblen Vorlagen
GET/studio/api/mallarVorlagen – versionierte Schemas mit Pflichtfeldern, erlaubten Blöcken und Ressorts (Nachricht, Reportage, Liste, Rezept, Auswahl, Guide, Rezension, Seite, Testsieger, Anleitung …)
GET/studio/api/agenterAgenten-Konten ADMIN
POST/studio/api/agenterEin Agentenkonto anlegen – der Schlüssel wird einmal angezeigt ADMIN
GET/studio/api/apparDie App-Bibliothek: jede App-Familie mit ihrer Nutzung über 7 und 30 Tage
GET/studio/api/oversiktDie Übersicht: Entwürfe, Prüfwarteschlange, fehlende Sprachen, anstehend, fehlgeschlagen, kürzlich veröffentlicht
GET/studio/api/mallar/{id}Eine Vorlage
PATCH/studio/api/agenter/{id}Die Rechte eines Agenten ändern oder seinen Schlüssel widerrufen ADMIN
GET/studio/api/rollerDie Studio-Rollen der Redaktion ADMIN
PUT/studio/api/rollerRolle, Ressorts und Sprachen für ein Konto festlegen ADMIN
GET/studio/api/installningarEinstellungen: dritte Sprache, Live-Modus, Oberflächensprache
PUT/studio/api/installningarDie Einstellungen ändern ADMIN
GET/studio/api/loggDas vollständige Protokoll (Admin und Veröffentlichungsberechtigte)
GET/studio/api/exportAlle Inhalte, Sprachversionen, Revisionen, Medien und Veröffentlichungen als JSON exportieren (Admin) – niemals Agentenschlüssel
GET/studio/api/openapi.jsonDiese Spezifikation. ?urval=chatgpt liefert die Operationen, die ein schreibender Agent braucht (ChatGPT Actions nehmen höchstens 30 an)