Quelqu’un l’a déjà construit.

Une annonce est un workflow ou une automatisation que quelqu’un a fait marcher, partagé comme quelque chose que vous pouvez exécuter. Vous l’installez — gratuitement — vous rattachez vos propres identifiants et entrées aux emplacements qu’elle déclare, et vous l’exécutez : POST /api/marketplace/listings/{slug}/run. Vous exécutez une annonce ; vous ne la lisez pas.

parcourir ▸ filtres

Trouvez-en une qui marche déjà.

GET /api/marketplace/listings prend les filtres ci-dessous, et GET /api/marketplace/listings/{slug} en lit une en entier. Les résultats portent des performances mesurées, pas des adjectifs.

Ce que dit une carte d’annonce

Chaque carte porte les mêmes signaux mesurés : deux annonces pour le même travail sont donc directement comparables.

• Latence, taux de réussite et taux de ponctualité — mesurés sur de vraies exécutions.
• Un indicateur de pic d’échecs quand les exécutions récentes se dégradent.
• Le palier de réputation du créateur.
• Son rang dans l’ensemble de capacités où elle concourt.

installation ▸ gratuite

L’installation est gratuite, et elle est idempotente.

POST /api/marketplace/listings/{slug}/install pose l’annonce sur votre compte. L’appeler deux fois ne l’installe pas deux fois — une installation est idempotente par compte et par annonce. Ce qui atterrit est un snapshot figé et sans données : les étapes, plus le manifest des emplacements qu’elle demande, les identifiants du créateur ayant été retirés à la publication.

rattachements ▸ la couture

Vous rattachez vos propres identifiants. C’est tout le principe.

Une annonce déclare des emplacements : la connexion dont elle a besoin, le secret dont elle a besoin, les entrées qu’elle prend. Elle n’embarque pas ceux du créateur. Vous remplissez les emplacements avec ce qui vous appartient, et une exécution les résout depuis vos rattachements et de nulle part ailleurs. Lisez les emplacements avec GET /api/marketplace/installs/{slug}/manifest, avant ou après l’installation.

Poser et retirer un rattachement

PUT /api/marketplace/installs/{slug}/bindings pose un emplacement ; DELETE avec ?slot_kind= et ?slot_key= le retire. Le corps tient en cinq champs :

Installer, rattacher, exécuter

Les quatre appels dans l’ordre où vous les faites.

# 1. See what slots this listing needs before you install it.
curl https://api.usewrit.app/api/marketplace/installs/invoice-puller/manifest \
  -H "Authorization: Bearer $WRIT_API_KEY"

# 2. Install. Free, and idempotent per account + listing.
curl -X POST https://api.usewrit.app/api/marketplace/listings/invoice-puller/install \
  -H "Authorization: Bearer $WRIT_API_KEY"

# 3. Bind YOUR persona and YOUR secret into the slots it declared.
curl -X PUT https://api.usewrit.app/api/marketplace/installs/invoice-puller/bindings \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slot_kind": "persona", "slot_key": "login", "persona_id": 12}'

curl -X PUT https://api.usewrit.app/api/marketplace/installs/invoice-puller/bindings \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slot_kind": "input", "slot_key": "account_number", "input_value": "88213"}'

# 4. Run it. Everything it signs in with came from step 3.
curl -X POST https://api.usewrit.app/api/marketplace/listings/invoice-puller/run \
  -H "Authorization: Bearer $WRIT_API_KEY"

// A workflow install declares these slot kinds:
{ "slot_kind": "persona", "slot_key": "login",   "persona_id": 12 }
{ "slot_kind": "secret",  "slot_key": "api_key", "vault_secret_ref": "acme-key" }
{ "slot_kind": "input",   "slot_key": "region",  "input_value": "eu-west" }

// An automation install adds two more:
{ "slot_kind": "monitor_url",      "slot_key": "watch",  "input_value": "https://example.com/pricing" }
{ "slot_kind": "notify_recipient", "slot_key": "alerts", "input_value": "[email protected]" }

// Clearing one is a DELETE with the same two identifiers:
// DELETE /api/marketplace/installs/{slug}/bindings?slot_kind=input&slot_key=region

# Where this install sits against the creator's caps.
curl https://api.usewrit.app/api/marketplace/installs/invoice-puller/usage \
  -H "Authorization: Bearer $WRIT_API_KEY"

# Everything you have installed.
curl https://api.usewrit.app/api/marketplace/installs -H "Authorization: Bearer $WRIT_API_KEY"

# A run went wrong — open a report.
curl -X POST https://api.usewrit.app/api/marketplace/installs/invoice-puller/report \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "The run signed in but returned no rows."}'

# Your own reports: open | reviewing | resolved | dismissed.
curl https://api.usewrit.app/api/marketplace/reports -H "Authorization: Bearer $WRIT_API_KEY"

exécution ▸ ce qui est garanti

Ce qu’une exécution promet.

POST /api/marketplace/listings/{slug}/run exécute l’annonce sur votre compte. Quatre choses tiennent à chaque exécution :

1. Elle utilise vos rattachements, et seulement les vôtres — Personas, identifiants, secrets et entrées sont résolus depuis ce que vous avez rattaché. Rien n’arrive du créateur.
2. Elle exécute le snapshot que vous avez installé — L’installation fige la recette telle qu’elle était ce jour-là. Un créateur qui modifie son workflow en direct ne change pas ce que votre installation exécute.
3. Un emplacement requis manquant la bloque — L’exécution répond 422 au lieu de démarrer et d’échouer à mi-chemin. Rattachez l’emplacement, relancez.
4. L’annonce elle-même est gratuite — Aucun frais d’annonce, aucune commission du créateur sur une exécution. Ce qu’une exécution peut coûter, c’est le compute de la plateforme Writ : rien sur votre propre machine, du temps d’exécution facturé sur la flotte cloud managée.

Le reste du cycle de vie

Tout ce que vous pouvez faire d’autre avec une installation :

avis ▸ exécutions vérifiées

Les avis viennent de gens qui l’ont exécutée.

Seule une personne qui a installé une annonce et accumulé assez d’exécutions réussies peut la noter, et une organisation dispose d’un avis. C’est pourquoi les notes suivent les signaux mesurés au lieu de s’en éloigner.

problèmes ▸ signalements

Quand ça ne tient pas ses promesses.

Signalez l’exécution qui a mal tourné. Le créateur et les administrateurs de la plateforme sont prévenus, et une annonce qui accumule des signalements non résolus est marquée pour examen.

publier ▸ créateurs

Publier la vôtre.

POST /api/marketplace/publish exige un compte vérifié et accept_creator_agreement: true. N’importe quel plan, Free compris, peut publier, et ce que vous publiez est une recette gratuite : vos personas, secrets et sessions sont retirés à la publication, donc ce que les autres installent ne peut jamais les contenir. Le corps décrit l’actif et les garde-fous que vous voulez sur chaque exécution.

Publier une recette

L’appel de publication, et les garde-fous qui l’accompagnent.

curl -X POST https://api.usewrit.app/api/marketplace/publish \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accept_creator_agreement": true,
    "asset_type": "workflow",
    "workflow_id": 41,
    "title": "Invoice puller",
    "summary": "Signs in and pulls every invoice since a date you pass in.",
    "category": "finance",
    "keywords": ["invoices", "accounting"],
    "tags": ["billing"],
    "intent": "Pull invoices from a billing portal",
    "baseline_duration_ms": 18000,
    "marketplace_exec_policy": "cloud",
    "usage_limits": {
      "per_buyer": { "count": 200, "window": "day", "mode": "enforce" },
      "global": { "count": 20000, "window": "month", "mode": "enforce" },
      "max_concurrent_per_buyer": { "count": 4, "mode": "enforce" }
    },
    "input_rules": {
      "rules": {
        "account_number": { "pattern": "^[0-9]{4,8}$", "message": "4 to 8 digits" }
      }
    }
  }'

// usage_limits — three independent caps, each with its own mode.
// mode:   "off" | "warn" | "enforce"
// window: per_buyer "day" | "month"   ·   global "day" | "month" | "lifetime"
{
  "per_buyer":                { "count": 200,   "window": "day",   "mode": "enforce" },
  "global":                   { "count": 20000, "window": "month", "mode": "enforce" },
  "max_concurrent_per_buyer": { "count": 4,                        "mode": "enforce" }
}

// input_rules — one regex per input or secret slot, checked on every run.
// flags: any subset of "i", "m", "s". message is what the runner is shown.
{
  "rules": {
    "account_number": { "pattern": "^[0-9]{4,8}$", "flags": "", "message": "4 to 8 digits" }
  }
}

pi ▸ exécuter, pas lire

On exécute une annonce. On ne la lit pas.

Si vous publiez une recette que vous avez mis des semaines à régler, la partager ne doit pas revenir à la céder. C’est une contrainte de conception, pas une promesse — voici donc exactement comment c’est agencé :

1. L’installation fige un snapshot sans données — Ce qui atterrit sur le compte d’un tiers est la forme de la recette, sans les données sur lesquelles elle a été construite.
2. Aucun endpoint côté installation ne rend les étapes — Il n’existe pas de chemin de lecture de la recette. Ni sur l’annonce, ni sur l’installation, ni sur une exécution.
3. Le chemin desktop reçoit une recette scellée — Quand une exécution se fait sur une machine, cette machine reçoit une forme qu’elle seule peut ouvrir.

référence ▸ suite

Autour du marketplace

faq

Questions marketplace, répondues.

fin ▸ en installer une

Installez-en une et rattachez votre propre connexion.

Le manifest dit quels emplacements une annonce demande avant même que vous ne l’installiez. Lisez-le d’abord, installez ensuite.