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écritureDELETE /api/matrices/{id}Delete a matrixécriture
Elements
POST /api/matrices/{id}/elementsAdd an element to a quadrantécriturePUT /api/matrices/{id}/elements/{elementId}Update an elementécritureDELETE /api/matrices/{id}/elements/{elementId}Delete an elementécritureGET /api/matrices/{id}/elements/{elementId}/measurementsList a KPI's readingslecturePUT /api/matrices/{id}/elements/{elementId}/measurementsRecord or correct the reading of a periodécritureGET /api/matrices/{id}/elements/{elementId}/updatesList the progress updates of an elementlecturePOST /api/matrices/{id}/elements/{elementId}/updatesLog a progress update: a percentage, a comment, or bothécriturePUT /api/matrices/{id}/elements/{elementId}/sheetFill or change an initiative's sheetécriturePUT /api/matrices/{id}/elements/{elementId}/kpi-definitionDefine how a KPI is computed and where it is readé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}/imageDraw the X-Matrix as an SVG picturelectureGET /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 levellectureGET /api/agendaWhere the organization stands in its review cycle, and what is duelecturePOST /api/meetingsSchedule a review of a cadenceécriturePATCH /api/meetings/{id}/completeRecord a review that was held: notes, decisions, elements discussedécritureGET /api/meetings/{id}/snapshotA recorded review, with the state of the matrix it sawlectureGET /api/cadencesList the review cadences of the organizationlecturePOST /api/cadencesCreate a review cadence (monthly committee, quarterly review…)écriturePATCH /api/cadences/{id}Change a review cadenceécriture
Identity
GET /api/whoamiWho is calling, with what rights, under which planlectureGET /api/membersThe directory of the organization: who can own an elementlecturePOST /api/capability-requestsTell us what you needed and did not findlecture