Extrayez les paramètres de chemin OpenAPI dans l’ordre

Cette capacité parcourt un modèle de gauche à droite, restitue chaque paramètre à sa place et refuse toute accolade ouvrante ou fermante non appariée. Déterministe et sans accès réseau, elle fournit toujours le même résultat pour une entrée identique et convient ainsi aux scripts de compilation, validations, éditeurs et processus API automatisés.

Transformez un modèle de chemin en liste ordonnée

Une opération OpenAPI peut employer un chemin tel que <code>/users/{id}/posts/{postId}</code>, alors que les outils associés ont besoin des noms <code>id</code> et <code>postId</code> comme valeurs distinctes. L’extracteur lit le modèle du premier au dernier caractère et restitue les paramètres dans ce même ordre. Cet ordre est important, car un constructeur de requêtes, un serveur simulé, un exemple de documentation ou un générateur de tests peut associer les valeurs aux positions qu’elles occupent dans l’URL. L’analyse ne trie pas, ne déduplique pas, ne renomme pas et ne normalise pas le texte capturé. Si un nom figure deux fois, il apparaît deux fois dans le résultat, qui représente ainsi fidèlement le modèle fourni. Les segments statiques sont ignorés : barres obliques, versions, signes de ponctuation et texte ordinaire hors des accolades n’ajoutent aucun bruit. Un modèle sans segment délimité par des accolades est valide et produit une liste vide. Ce comportement ciblé rend le résultat prévisible et facile à intégrer à un traitement OpenAPI plus large, sans transformation implicite.

Repérez les accolades incorrectes avant les traitements suivants

Une accolade manquante peut détériorer silencieusement la suite du traitement. Par exemple, un générateur pourrait interpréter le reste du chemin comme un seul paramètre, ou un moteur de documentation afficher un modèle incapable de correspondre à une requête. L’extracteur refuse donc une accolade fermante sans ouverture préalable, une accolade ouvrante jamais refermée et une seconde ouverture rencontrée avant la fermeture du paramètre en cours. L’erreur indique la position de l’accolade, ce qui accélère le diagnostic dans les journaux de compilation ou les outils interactifs. La validation a lieu pendant le même parcours linéaire que l’extraction : aucun état d’analyse séparé ne peut donc contredire la liste renvoyée. Les modèles équilibrés sont traités normalement, y compris ceux qui répètent des noms ou ne contiennent aucun paramètre. Cette capacité se limite à la structure des accolades ; elle ne valide pas un document OpenAPI complet, ne vérifie pas l’existence des objets de paramètre déclarés et ne décide pas si un nom respecte les conventions de votre équipe. Ces contrôles plus généraux relèvent d’un validateur de schéma ou de spécification.

Exploitez le résultat dans les générateurs, tests et outils API

La liste renvoyée constitue une petite valeur intermédiaire facile à composer. Un générateur de code peut la comparer aux paramètres de chemin déclarés par l’opération, un outil de test créer un champ de données par nom et une interface de requête afficher ses contrôles dans l’ordre du chemin. Un analyseur peut également lancer l’extraction en premier et s’arrêter aussitôt si les accolades sont incorrectes, ce qui évite des erreurs secondaires difficiles à comprendre. L’algorithme se limite à un parcours déterministe des caractères : il n’effectue aucun appel réseau, ne conserve pas l’entrée, n’emploie aucune valeur aléatoire et ne dépend pas de l’heure. Il peut donc être répété sans risque en intégration continue et mis en cache selon l’entrée. Envoyez le modèle dans le champ <code>text</code>, puis lisez la liste ordonnée dans <code>parameters</code>. Une exécution par API coûte $0.002 par requête, tandis que la version pour navigateur peut fonctionner localement. Cette capacité extrait les noms d’un seul modèle ; elle ne résout pas les variables de serveur, ne remplace pas les valeurs, n’encode pas les segments d’URL et n’analyse pas un fichier OpenAPI YAML ou JSON complet.