recipe_publish

macOS

Objectif

Soumet l’une de VOS recettes/skills enregistrées à la file de modération de la communauté pour examen par Dario ; cela ne la publie PAS. Sans confirm=true, elle affiche un APERÇU du titre, de la catégorie, des apps et de la description du flux qui seraient envoyés (rien ne quitte ce Mac) ; avec confirm=true, elle la soumet et renvoie {status:"submitted", pending:true}. Une fois approuvée, elle apparaît sur /community/skills et chacun peut l’installer avec recipe_install. `workflow` est la description publique : par défaut, elle reprend le champ `description` de la recette si celui-ci compte au moins 15 caractères ; sinon, indiquez-la explicitement.

Entrées requises

• name

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "properties": {
    "apps": {
      "description": "Free-text apps the recipe touches (e.g. \"Mail, Calendar\"), shown in the moderation queue.",
      "type": "string"
    },
    "category": {
      "description": "Free-text category shown in the moderation queue and, once approved, on /community/skills.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually submit. Without it, returns a preview — nothing is sent.",
      "type": "boolean"
    },
    "name": {
      "description": "Name of the saved recipe/skill to publish (see recipe_list).",
      "type": "string"
    },
    "title": {
      "description": "Shown once approved on /community/skills. Defaults to the recipe's own name.",
      "type": "string"
    },
    "workflow": {
      "description": "The public write-up of what the recipe does. Defaults to the recipe's own `description` if it's at least 15 characters; required otherwise.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour recipe_publish. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "confirm": false,
  "name": "Demo morning brief"
}