Les consommateurs que vous connaissez ne sont pas la liste
Changer un endpoint est une décision prise contre une liste mentale de consommateurs, et la liste mentale est toujours courte. Le service interne dont tout le monde se souvient, le client mobile, peut-être un partenaire. L'intégration construite il y a deux ans par une équipe depuis dissoute n'y est pas.
La vraie liste tient en deux endroits : l'historique de spécification, qui dit ce qu'était le contrat, et les journaux d'accès, qui disent qui l'a utilisé et combien récemment.
La casse n'est pas uniforme non plus. Un champ optionnel retiré casse le consommateur qui le lit et personne d'autre. Savoir lequel est lequel transforme une annonce large en trois conversations précises.
Produire la liste avant le changement est peu coûteux. La produire après est un incident.
Comment l'ActionFlow s'exécute sur le canevas
Les fichiers de spécification sont lus par un nœud GitHub aux deux versions. Un nœud Extract Data réduit chacune à sa surface : endpoints, paramètres, indicateurs exigés et champs de réponse.
Un nœud Generate Object les compare et renvoie le jeu de changements comme différences typées (retiré, renommé, désormais exigé, type changé) plutôt que comme un diff textuel.
Un nœud HTTP Request tire l'identité des consommateurs et les schémas d'appel depuis votre passerelle ou vos analyses pour la période que vous fixez. Un nœud Uniq les réduit à des consommateurs distincts.
Un nœud Loop parcourt ces consommateurs. Pour chacun, un nœud Generate Object renvoie lesquelles des différences typées s'appliquent à ce que ce consommateur envoie et lit réellement.
Comparer aux appels observés plutôt qu'à la spécification, c'est la décision qui rend le résultat vrai. La plupart des consommateurs n'utilisent qu'une fraction d'un endpoint.
Un nœud Filter écarte les consommateurs que rien ne touche, ce qui est en général la plupart. Un nœud Sort ordonne le reste par gravité.
Un nœud Create Excel produit le tableau d'impact. Un nœud Linear ouvre la tâche de migration.
Un nœud Email du groupe Human in the Loop retient l'avis aux consommateurs pour votre approbation. Rien ne part vers un développeur externe sans qu'une personne ne le libère.
Nœuds utilisés par cet ActionFlow
- GitHub (Integration) : fichiers de spécification aux deux versions.
- Extract Data (Data) : réduit chaque version à sa surface.
- Generate Object (AI Core) : différences typées, pas un diff textuel.
- HTTP Request (Util) : identité des consommateurs et schémas d'appel depuis la passerelle.
- Uniq (Control) : consommateurs distincts à partir des enregistrements d'appel bruts.
- Loop (Control) avec Generate Object (AI Core) : impact par consommateur, contre les appels observés.
- Create Excel (Data) : le tableau d'impact, ordonné par gravité.
- Email (Human in the Loop) : les avis externes attendent une personne.
Questions fréquentes
Newsletter
Recevoir les mises à jour produit
Nouveaux nœuds, agents et notes produit. Nous n'envoyons un e-mail que lorsqu'il vaut la peine de l'ouvrir.