L'icône de l'application Stampdrill

Votre travail d'API en texte brut, dans Git.

Un fichier .stamp contient la requête, les vérifications, le plan de test, le test de charge et le test de concurrence. Il apparaît dans le diff d'une pull request, se fusionne comme du code et s'exécute de la même façon pour une personne, pour la CI et pour un agent. HTTP, GraphQL, WebSockets et serveurs MCP ; aucun compte, aucun espace de travail dans le cloud, et rien ne quitte votre Mac hormis les requêtes que vous envoyez.

Obtenir Stampdrill L'essayer gratuitement Lire le langage

Pour macOS 14 ou ultérieur. $19.99 sur le Mac App Store. Le moteur et la commande stamp sont libres et open source.

La fenêtre de Stampdrill : un fichier .stamp dans l'éditeur, la réponse en dessous, et à droite les dimensions et les variables

Un fichier. L'application, le terminal ou votre éditeur.

Un fichier de requête est assez court pour se lire d'un coup d'œil. Ouvrez-le dans Stampdrill et envoyez-le d'un clic, ou exécutez-le depuis un shell avec les mêmes dimensions choisies.

api/orders.stamp

@base = {{host}}/api

### Log in
POST {{base}}/login
Content-Type: application/json

{ "username": "{{username}}", "password": "{{password}}" }

> assert status == 200
> set token = body.token

### Orders
@needs logIn
@auth bearer {{token}}
GET {{base}}/orders?limit=20

> assert all(body.items, o => o.total > 0)
> print length(body.items) + " orders" 

Terminal

$ stamp run api/orders.stamp env=staging region=latam
→ POST https://api.staging.latam.example.com/api/login  orders.stamp › logIn
  200 OK  142 ms  612 bytes
  ✓ status == 200

→ GET https://api.staging.latam.example.com/api/orders?limit=20  orders.stamp › orders
  200 OK  88 ms  4 KB
  ✓ all(body.items, o => o.total > 0)
  │ 20 orders

✓ 2 requests, 2 assertions

Des variables sur plus d'une dimension.

La plupart des outils vous donnent une liste d'environnements, et voilà staging-latam, staging-mena et prod-latam devenus trois copies à tenir synchronisées. Stampdrill vous laisse plutôt nommer les axes. Chaque jeu de variables dit où il s'applique, le plus précis l'emporte, et * signifie n'importe quelle valeur.

environment.stamp

dimension env = test, staging, prod
dimension region = latam, mena, apac, dach

vars {
  host = localhost(8080)
}

vars env=staging|prod {
  host = "api." + env + "." + region + ".example.com"
}

vars env=prod {
  password = secret(getenv("PROD_PASSWORD"))
}
Toutes les variables pour chaque combinaison de valeurs de dimension, dans un seul tableau

Tout ce dont une API a besoin, de la première requête au millième utilisateur.

Du texte brut, toujours

Les requêtes sont des fichiers .stamp : lisibles dans n'importe quel éditeur, relisibles dans une pull request, et jamais enfermés dans une application.

Une vraie application Mac

SwiftUI et AppKit, rapide à lancer et discrète à l'usage. Formulaire ou source sur le même fichier, et une extension d'éditeur si vous préférez rester dans VS Code.

Les mêmes fichiers dans un terminal

stamp run, test et load lisent exactement ce que lit l'application, avec des codes de sortie et des rapports JUnit, HTML ou JSON pour la CI.

Dimensions

Une dimension est un axe selon lequel votre API varie : l'environnement, la région, le type de compte. Nommez les axes une fois, et les variables qui conviennent suivent.

Plans de test

Étapes, boucles, conditions, reprises et délais, exécutés sur une matrice de dimensions et des données CSV ou JSON, en parallèle si besoin.

Tests de charge

Des utilisateurs virtuels avec montée en charge, temps de réflexion et seuils sur les centiles, le taux d'erreur et le débit, tracés en direct.

Conditions de concurrence

concurrently lance les acteurs ensemble et sync les aligne sur le même instant, de quoi faire apparaître un coupon utilisé deux fois ou une mise à jour perdue.

Apportez vos collections

Import des collections Postman, Insomnia et Bruno avec leurs environnements, des fichiers HAR, des commandes curl et des documents OpenAPI. Les identifiants rencontrés vont dans un fichier que Git ignore.

Fait pour Git

Un espace de travail est un dossier de fichiers texte posé dans le dépôt, à côté de votre code. Les valeurs personnelles vont dans un fichier que Stampdrill tient hors de Git.

Conçu pour le terminal et pour la CI.

stamp est gratuit et open source sous la Mozilla Public License 2.0. Il exécute les requêtes, les plans de test, les tests de charge et les tests de serveurs MCP depuis le même espace de travail que l'application, sort avec 1 lorsqu'une vérification échoue et 2 lorsqu'un fichier comporte des erreurs, masque les secrets dans sa sortie et écrit des rapports que votre CI comprend déjà. Il existe des binaires pour macOS et des binaires entièrement statiques pour Linux en x86_64 et arm64.

Installer

$ stamp run api/orders.stamp env=staging region=latam
→ POST https://api.staging.latam.example.com/api/login  orders.stamp › logIn
  200 OK  142 ms  612 bytes
  ✓ status == 200

→ GET https://api.staging.latam.example.com/api/orders?limit=20  orders.stamp › orders
  200 OK  88 ms  4 KB
  ✓ all(body.items, o => o.total > 0)
  │ 20 orders

✓ 2 requests, 2 assertions

Ce que cela coûte

Rien, y compris en usage commercial et en CI. Aucun compte, aucune inscription, aucune limite de requêtes. L'application Mac est la fenêtre sur ces mêmes fichiers, et elle n'est pas nécessaire pour commencer.

Voir sur GitHub

Obtenir Stampdrill

L'application Mac coûte $19.99 sur le Mac App Store, en un seul achat, pour macOS 14 ou ultérieur. Elle s'ouvre sur un espace de travail d'exemple qui interroge des API de test publiques : il y a donc tout de suite quelque chose à envoyer.

Acheter sur le Mac App Store Essayer gratuitement dans le terminal

Dans l'Union européenne, l'application n'est pas disponible pour l'instant. Elle est vendue dans tous les pays sauf les 27 de l'UE, tant qu'une adresse commerciale enregistrée fait défaut. L'outil en ligne de commande n'est pas concerné : il est disponible partout, gratuit et open source, et il lit les mêmes fichiers.