Guía rápida

1. Crea una cuenta y una aplicación. Inicia sesión en trustysweep.com, abre Developers, crea una organización y una aplicación. Sin pasos de aprobación.

2. Crea una clave de prueba. Dentro de la aplicación, crea una clave de API en modo test (sk_test_…). Las claves de prueba operan sobre un inquilino simulado y aislado con datos sintéticos de Gmail y Drive.

3. Siembra el modo de prueba. Esto crea una conexión delegada (cxn_…) y fuentes simuladas para recorrer el flujo completo.

   curl -X POST https://api.trustysweep.com/v1/developer/applications/app_…/test-mode/seed \
     -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" \
     -d '{"scenario":"storage_pressure"}'

4. Haz una llamada de solo lectura. El diagnóstico gratuito es la primera llamada canónica.

   curl

   curl "https://api.trustysweep.com/v1/diagnosis?connection_id=cxn_…" -H "Authorization: Bearer sk_test_…"

   TypeScript

   import { TrustySweep } from "@trustysweep/sdk";
   const sweep = new TrustySweep({ apiKey: process.env.SWEEP_API_KEY });
   const d = await sweep.diagnosis.get({ connection_id: "cxn_…" });
   console.log(`${(d.reclaimable_bytes / 1e9).toFixed(1)} GB recuperables, salud ${d.account_health}`);

   Python

   from trustysweep import TrustySweep
   sweep = TrustySweep("sk_test_...")
   d = sweep.diagnosis.get(connection_id="cxn_...")
   print(d["reclaimable_bytes"], d["account_health"])

   CLI

   npm i -g @trustysweep/cli
   sweep auth login --key sk_test_…
   sweep diagnosis -c cxn_…

5. Ejecuta un Sweep simulado. En modo de prueba los planes siempre son simulados: recorren todo el ciclo de vida y emiten un comprobante sin tocar ningún proveedor.

   const sources = await sweep.sources.list({ connection_id: "cxn_…" }).all();
   const result = await sweep.sweep({ intent: "sweep", connection_id: "cxn_…", source_ids: sources.map((s) => s.id), selection: { classes: ["promotional", "large_attachment"], min_confidence: 0.85 }, simulate: true });
   console.log(result.execution.status, result.receipt.receiptId);

6. Pasa a producción. Crea una clave live, agrega un webhook y envía a tus usuarios reales por Sweep Connect.