HTTP API Tester pour Openclaw

Openclaw Skills transforme les descriptions d'endpoints en tests de fumée curl réutilisables avec timing, assertions de statut et sortie de shell prête pour la CI.

kingaiwork
v1.0.0
Jul 16, 2026
0
0
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install http-api-tester

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer http-api-tester via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que HTTP API Tester ?

Openclaw Skills propulse HTTP API Tester, un flux de travail qui convertit les descriptions d'endpoints - méthode, route, authentification et exemples de paramètres - en tests de fumée curl réutilisables. Il est conçu pour valider les vérifications de l'état de santé (health checks), les réponses de succès attendues, les codes d'erreur et les échecs d'authentification sans avoir à concevoir manuellement des scripts uniques pour chaque endpoint.

La sortie générée ajoute des rapports de statut et de timing -s -w, peut émettre des variantes d'assertion par lot JSON pour jq, et est exportable sous forme de shell exécutable en CI. L'édition locale gratuite couvre le générateur de base, tandis que l'option entreprise débloque l'échelle des lots, le réglage avancé, l'intégration de l'automatisation des API et le support prioritaire.

Cas d'utilisation de HTTP API Tester

  • Générer une suite de tests de fumée curl réutilisable à partir d'une liste brute d'endpoints d'API.
  • Vérifier les contrôles de santé, les réponses réussies, les chemins d'erreur et les échecs d'authentification.
  • Ajouter des assertions de code d'état et des rapports de latence aux vérifications d'API existantes.
  • Produire une validation par lot orientée JSON qui s'associe à jq.
  • Packager les mêmes vérifications pour une exécution locale et des pipelines de CI tels que GitHub Actions.
  • Standardiser les tests de régression lorsque les API changent fréquemment ou sont partagées entre les équipes.

Comment fonctionne HTTP API Tester

  1. Fournir l'inventaire de l'API : méthode HTTP, chemin, exigences d'authentification, en-têtes et exemples de paramètres.
  2. La compétence classifie chaque endpoint dans des scénarios de test tels que la couverture de la santé, du succès, de l'erreur et de l'échec d'authentification.
  3. Elle génère des commandes curl avec une sortie -s -w pour que chaque requête affiche le statut HTTP et les détails de timing.
  4. Elle superpose des assertions, y compris des vérifications facultatives de lots JSON qui peuvent être validées avec jq.
  5. Le résultat est exporté sous forme de script Bash qui peut être exécuté localement ou déposé directement dans la CI pour des tests de fumée d'API répétables.

Configuration de HTTP API Tester

Openclaw Skills est une compétence d'IA, il n'y a donc pas de package à installer pour la compétence elle-même. Configurez les outils d'exécution qui exécuteront les tests générés, puis fournissez les descriptions de vos endpoints à la compétence.

  1. Installez les dépendances en ligne de commande utilisées par les scripts générés :
# macOS
brew install curl jq

# Ubuntu ou Debian
sudo apt-get update
sudo apt-get install -y curl jq
  1. Préparez un bref aperçu de l'API pour chaque endpoint : méthode, chemin, authentification, en-têtes, exemples de paramètres et l'état de succès ou d'échec attendu.

  2. Demandez à la compétence de générer le shell du test de fumée. Enregistrez le résultat dans un fichier tel que api_smoke_tests.sh.

  3. Rendez le script exécutable et exécutez-le localement :

chmod +x api_smoke_tests.sh
.\/api_smoke_tests.sh
  1. Pour la CI, validez le script dans votre dépôt et appelez-le depuis une étape de flux de travail afin que les mêmes vérifications s'exécutent sur chaque build.

Schéma de données et taxonomie de HTTP API Tester

La compétence fonctionne à partir d'un mappage simple d'endpoint à test et émet un artefact de vérification basé sur le shell.

Couche Champs typiques Objectif
Spécification d'API d'entrée method, path, auth, headers, query/body parameters, example values, expected status Décrit ce qu'il faut tester
Taxonomie des scénarios health, success, error, auth-failure Divise chaque endpoint en catégories de couverture
Modèle de commande drapeaux curl, charge utile (payload), en-têtes, rapporteur -s -w Construit des vérifications HTTP exécutables
Couche d'assertion HTTP status, body pattern, timing, vérifications jq, exit code Valide la réponse
Métadonnées d'exécution http_status, duration_ms, exit_code, response_excerpt Prend en charge le suivi de la CI et de la régression
Artefact de sortie script Bash, blocs d'assertion de lot JSON facultatifs Généralement un fichier .sh exécutable plus des vérifications facultatives lisibles par machine

Les métadonnées sont généralement organisées par identifiant d'endpoint, méthode HTTP, route, mode d'authentification, nom du scénario, code d'état attendu et toute vérification de corps ou de timing. Le contenu généré est intentionnellement plat et adapté au shell afin de pouvoir être copié dans GitHub Actions, des tâches cron ou d'autres exécuteurs d'automatisation sans emballage supplémentaire.

Fonctionnalités avancées de HTTP API Tester

  • Inclut automatiquement le rapport -s -w afin que chaque requête affiche les données de statut et de timing.
  • Génère plusieurs modes de vérification à partir du même résumé d'endpoint : santé, succès, erreur et échec d'authentification.
  • Prend en charge les assertions de lot JSON et la validation basée sur jq pour les vérifications lisibles par machine.
  • Exporte une sortie Bash propre qui peut être réutilisée sans modification dans les pipelines de CI.
  • Évolue d'un endpoint unique à une suite de tests de fumée multi-endpoint pour la couverture de régression.
  • Le niveau entreprise ajoute l'utilisation par lots ou illimitée, le réglage avancé, l'accès aux API et à l'automatisation, et un support prioritaire avec SLA.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*