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
- openapi.json
OpenAPI 3.0.3, pour la plupart des outils.
- swagger.json
Swagger 2.0, la seule version qu'importe un connecteur personnalisé Microsoft.
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
- Dans Power Automate, ouvrez Solutions, puis Nouveau, Automatisation, Connecteur personnalisé, et choisissez Importer un fichier OpenAPI.
- Sélectionnez swagger.json. L'étape de sécurité demande déjà une clé d'API dans l'en-tête Authorization.
- À 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 matriceslecturePOST /api/matricesCreate a matrixécritureGET /api/matrices/{id}Get a matrix with its elements and linkslecturePUT /api/matrices/{id}Update a matrixécriture
Elements
POST /api/matrices/{id}/elementsAdd an element to a quadrantécriturePUT /api/matrices/{id}/elements/{elementId}Update an elementécriturePUT /api/matrices/{id}/correlationsSet or remove a link between two elementsécriture
Analysis
GET /api/matrices/{id}/completenessGet the completeness score of a matrixlectureGET /api/matrices/{id}/cascadeGet the cascade below a matrixlecture
Sharing
GET /api/matrices/{id}/sharesList the public links of a matrixécriturePOST /api/matrices/{id}/sharesPublish a matrix on a public read-only linkécritureDELETE /api/matrices/{id}/shares/{shareId}Revoke a public linkécriture
Ideas
GET /api/ideasList or search ideaslecturePOST /api/ideasAdd an idea to the inboxécriturePUT /api/ideas/{id}Update an ideaécriture
Exports
GET /api/exports/matricesExport all matriceslectureGET /api/exports/summaryGet an overview of the organizationlecture
Themes
GET /api/themesList strategic themeslectureGET /api/themes/{id}Get a strategic theme with its elementslecture
Cadences
GET /api/cadences/architectureGet the meeting cadences by levellecture