Aller au contenu

Développeurs · VOR API 2.5.43

Une API pour les rédacteurs et leurs agents IA

VOR API est l'interface de programmation de VOR Studio. Tout ce qu'un rédacteur fait dans Studio – brouillons, traduction, aperçu, programmation, publication, médias – un agent peut le faire par la même API, avec exactement les droits qu'un administrateur lui donne.

Qui suis-je ?GET /studio/api/jag
$ curl https://your-domain.com/studio/api/jag \
    -H "Authorization: Bearer $VOR_AGENT_KEY"

{
  "ok": true,
  "release": "2.5.43",
  "vem": {
    "typ": "agent",
    "roll": "agent",
    "sektioner": ["mode", "skonhet"],
    "sprak": ["sv", "en"],
    "publicera": false,
    "schemalagga": false
  }
}
84opérations dans l'API
72points de terminaison, une seule spécification
23outils dans le connecteur VOR Studio
11outils dans le connecteur VOR Insights

En direct · comptés à partir de la spécification et des connecteurs à chaque chargement de cette page

Comment un agent obtient l'accès

Les agents n'obtiennent jamais plus que ce qu'on leur donne. Par défaut, c'est un auteur qui remet des brouillons ; une personne décide de ce qui est mis en ligne.

  1. Un administrateur crée l'agent

    Dans VOR Studio › Agents. La clé n'est affichée qu'une fois, à l'administrateur.

  2. L'agent envoie sa clé

    Dans chaque requête : Authorization: Bearer mms_…

  3. Il commence par des brouillons

    Publication et programmation uniquement dans les rubriques, gabarits et langues que l'administrateur autorise.

  4. Chaque enregistrement est une révision

    Les versions linguistiques sont des révisions immuables. Deux auteurs en même temps reçoivent un 409 au lieu de s'écraser mutuellement.

Se connecter depuis Claude ou ChatGPT

Aucune clé dans le chat. Claude se connecte par un bouton (OAuth avec PKCE), en tant que la personne qui l'utilise ; une Action ChatGPT reçoit sa clé d'agent dans les réglages du GPT.

Claude · MCP

Deux connecteurs : VOR Studio pour écrire et publier, VOR Insights pour le trafic, les revenus et la file des commandes.

https://your-domain.com/studio/mcp
https://your-domain.com/management/mcp

VOR Studio : 23 outilsVOR Insights : 11 outils

ChatGPT · Actions

Une sélection prête à l'emploi des opérations dont un agent rédacteur a besoin – les Actions ChatGPT en acceptent au plus 30. La publication et les changements de statut sont marqués pour que ChatGPT demande avant de les exécuter.

https://your-domain.com/studio/api/openapi-chatgpt.json

29 opérationsConnexion : clé d'agent

Ce que contient l'API

Chaque opération, regroupée selon la façon dont travaille une rédaction. Les chiffres sont des opérations. Tout voir →

20Contenu et révisions

Créer des brouillons, écrire des versions linguistiques comme révisions immuables, contrôler avant de publier, commenter et comparer.

15Aperçu et publication

Prévisualiser avec le rendu propre du site, partager des liens à durée limitée, publier maintenant ou de manière programmée, et suivre chaque publication.

5Traduction et tâches

Traduction par IA sous forme de brouillons – un article ou soixante à la fois – avec un statut de tâche à interroger.

9Médiathèque

Téléverser des images, conserver crédits et droits, rédiger le texte alternatif par langue et voir où chaque image est utilisée.

6Tags, catégories et personnes

Suggérer et définir des tags, créer des tags pour les noms et lire le dictionnaire des personnes du site.

8Commandes et idées

La file partagée entre rédacteurs et agents, et les idées issues de la veille médiatique.

4Liens commerciaux

Le moniteur de liens et les liens sortants du site vers les programmes d'affiliation.

17Compte, règles et administration

Qui vous êtes, le manuel de rédaction, gabarits et rubriques – et, pour les administrateurs, agents, rôles, réglages, journal et export.

Des erreurs qu'une machine peut traiter

Chaque erreur indique quel champ, dans quelle langue, pourquoi – et que faire. Les noms de champs et les messages sont en suédois, comme dans Studio.

falt
le champ
sprak
la version linguistique
orsak
ce qui n'a pas fonctionné
atgard
comment y remédier
Contrôlé avant publicationPOST …/validera
{
  "ok": false,
  "fel": [{
    "sprak": "en",
    "falt": "ingress",
    "orsak": "Ingress saknas",
    "atgard": "Skriv en ingress"
  }],
  "varningar": []
}