API REST Hoshin Kanri

Bêta : les opérations et les champs peuvent encore changer.

Pour un agent IA, utilisez MCP sur https://hoshin.app/mcp : aucun fichier à importer, et la méthode vient avec. Cette API sert aux automatisations qui ne parlent pas MCP, comme un flux Power Automate ou un script.

Les fichiers

Authentification

Un administrateur crée un jeton depuis le lien Jetons d'API, dans l'en-tête de l'application. Envoyez-le dans l'en-tête Authorization. Un jeton en lecture seule est refusé sur les opérations marquées écriture.

curl https://hoshin.app/api/matrices \
  -H "Authorization: Bearer hk_..."

Les opérations répondent à une erreur par un code stable, dans le champ error. Les messages restent en anglais : fiez-vous au code.

Power Automate et Logic Apps

  1. Dans Power Automate, ouvrez Solutions, puis Nouveau, Automatisation, Connecteur personnalisé, et choisissez Importer un fichier OpenAPI.
  2. Sélectionnez swagger.json. L'étape de sécurité demande déjà une clé d'API dans l'en-tête Authorization.
  3. À la création de la connexion, saisissez Bearer, une espace, puis votre jeton.

Ces étapes viennent de la documentation de Microsoft : nous n'avons pas encore fait cet import nous-mêmes. Vérifiez que votre licence Microsoft couvre les connecteurs personnalisés.

Opérations

Les opérations qu'utilise le serveur MCP de Hoshin. Leurs libellés restent en anglais, comme l'API. On ne peut pas supprimer ici une matrice ou un élément.

Matrices

  • GET /api/matricesList matriceslecture
  • POST /api/matricesCreate a matrixécriture
  • GET /api/matrices/{id}Get a matrix with its elements and linkslecture
  • PUT /api/matrices/{id}Update a matrixécriture

Elements

  • POST /api/matrices/{id}/elementsAdd an element to a quadrantécriture
  • PUT /api/matrices/{id}/elements/{elementId}Update an elementécriture
  • PUT /api/matrices/{id}/correlationsSet or remove a link between two elementsécriture

Analysis

  • GET /api/matrices/{id}/completenessGet the completeness score of a matrixlecture
  • GET /api/matrices/{id}/cascadeGet the cascade below a matrixlecture

Sharing

  • GET /api/matrices/{id}/sharesList the public links of a matrixécriture
  • POST /api/matrices/{id}/sharesPublish a matrix on a public read-only linkécriture
  • DELETE /api/matrices/{id}/shares/{shareId}Revoke a public linkécriture

Ideas

  • GET /api/ideasList or search ideaslecture
  • POST /api/ideasAdd an idea to the inboxécriture
  • PUT /api/ideas/{id}Update an ideaécriture

Exports

  • GET /api/exports/matricesExport all matriceslecture
  • GET /api/exports/summaryGet an overview of the organizationlecture

Themes

  • GET /api/themesList strategic themeslecture
  • GET /api/themes/{id}Get a strategic theme with its elementslecture

Cadences

  • GET /api/cadences/architectureGet the meeting cadences by levellecture