Alguien ya lo construyó.

Un listado es un workflow o una automatización que alguien consiguió que funcionara, compartido como algo que puedes ejecutar. Lo instalas — gratis — enlazas tus propias credenciales y entradas a las ranuras que declara, y lo ejecutas: POST /api/marketplace/listings/{slug}/run. Ejecutas un listado; no lo lees.

explorar ▸ filtros

Encuentra uno que ya funcione.

GET /api/marketplace/listings acepta los filtros de abajo, y GET /api/marketplace/listings/{slug} lee uno entero. Los resultados llevan rendimiento medido, no adjetivos.

Qué te dice la ficha de un listado

Cada ficha lleva las mismas señales medidas, así que dos listados para el mismo trabajo se comparan directamente:

• Latencia, tasa de éxito y tasa de puntualidad — medidas sobre ejecuciones reales.
• Un aviso de pico de fallos cuando las ejecuciones recientes han empeorado.
• El nivel de reputación del creador.
• Su posición dentro del conjunto de capacidades en el que compite.

instalación ▸ gratis

Instalar es gratis, y es idempotente.

POST /api/marketplace/listings/{slug}/install pone el listado en tu cuenta. Llamarlo dos veces no lo instala dos veces — una instalación es idempotente por cuenta y listado. Lo que aterriza es una instantánea congelada y sin datos: los pasos más el manifest de ranuras que necesita, con las credenciales del creador retiradas al publicar.

enlaces ▸ la costura

Enlazas tus propias credenciales. Ese es todo el diseño.

Un listado declara ranuras: el acceso que necesita, el secreto que necesita, las entradas que toma. No trae las del creador. Tú llenas las ranuras con cosas tuyas, y una ejecución las resuelve desde tus enlaces y desde ningún otro sitio. Lee las ranuras con GET /api/marketplace/installs/{slug}/manifest, antes o después de instalar.

Poner y quitar uno

PUT /api/marketplace/installs/{slug}/bindings pone una ranura; DELETE con ?slot_kind= y ?slot_key= la limpia. El cuerpo son cinco campos:

Instalar, enlazar, ejecutar

Las cuatro llamadas en el orden en que las haces.

# 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"

ejecución ▸ qué se garantiza

Qué promete una ejecución.

POST /api/marketplace/listings/{slug}/run ejecuta el listado en tu cuenta. Cuatro cosas se cumplen en cada ejecución:

1. Usa tus enlaces, y solo tus enlaces — Personas, credenciales, secretos y entradas se resuelven desde lo que enlazaste. Nada llega del creador.
2. Ejecuta la instantánea que instalaste — La instalación captura la receta tal como estaba ese día. Que el creador edite su workflow en vivo no cambia lo que tu instalación ejecuta.
3. Una ranura obligatoria vacía la bloquea — La ejecución responde 422 en vez de arrancar y fallar a medio camino. Enlaza la ranura y vuelve a ejecutar.
4. El listado en sí es gratis — No hay cargo por el listado ni comisión del creador en una ejecución. Lo que una ejecución puede costar es cómputo de la plataforma Writ: nada en tu propia máquina, tiempo de ejecución medido en la flota cloud gestionada.

El resto del ciclo de vida

Todo lo demás que puedes hacer con una instalación:

reseñas ▸ ejecuciones verificadas

Las reseñas vienen de quien lo ejecutó.

Solo quien instaló un listado y acumuló suficientes ejecuciones con éxito puede reseñarlo, y una organización tiene una reseña. Por eso las valoraciones siguen a las señales medidas en vez de separarse de ellas.

problemas ▸ reportes

Cuando no cumple.

Reporta la ejecución que salió mal. El creador y los administradores de la plataforma reciben aviso, y un listado que acumula reportes sin resolver se marca para revisión.

publicar ▸ creadores

Publicar el tuyo.

POST /api/marketplace/publish necesita una cuenta verificada y accept_creator_agreement: true. Cualquier plan, Free incluido, puede publicar, y lo que publicas es una receta gratuita: tus personas, secretos y sesiones se retiran al publicar, así que lo que otros instalan nunca puede contenerlos. El cuerpo describe el activo y las barreras que quieres en cada ejecución.

Publicar una receta

La llamada de publicación, y las barreras que van con ella.

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 ▸ ejecutar, no leer

La gente ejecuta un listado. No lo lee.

Si publicas una receta que te costó semanas afinar, compartirla no debería ser regalarla. Es una restricción de diseño, no una promesa — así que esto es exactamente cómo está montado:

1. La instalación captura una instantánea sin datos — Lo que aterriza en la cuenta de otra persona es la forma de la receta, sin los datos contra los que se construyó.
2. Ningún endpoint de instalación devuelve los pasos — No hay vía de lectura de la receta. Ni en el listado, ni en la instalación, ni en una ejecución.
3. La vía de escritorio recibe una receta sellada — Cuando una ejecución corre en una máquina, esa máquina recibe una forma que solo ella puede abrir.

referencia ▸ siguiente

Alrededor del marketplace

faq

Preguntas de marketplace, respondidas.

fin ▸ instalar uno

Instala uno y enlaza tu propio acceso.

El manifest te dice qué ranuras pide un listado antes de que lo instales. Léelo primero, instala después.