Skip to main content

SDK & API

Integrá la confianza en tu app.

Usá la API REST de SecureStamp o el SDK oficial para verificar dominios y emails desde tu backend, CLI, o CI/CD.

TypeScript nativo

Tipos completos, inferencia automática.

Privacy-first

Solo metadatos — nunca contenido de email.

Edge ready

Compatible con Node.js, Cloudflare Workers, Deno.

Zero deps

Sin dependencias de runtime.

Requiere API key

El SDK y la API REST directa requieren una API key. Las cuentas Business y Enterprise pueden generarlas desde el dashboard.

Ir al dashboard →

Endpoint gratuito (sin key)

El endpoint de verificación pública no requiere autenticación. Tiene un límite de cuota generoso para uso exploratorio.

curl
# No API key required — uses shared quota
curl -X POST https://securestamp.online/api/trust/check \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
@securestamp/sdknpmnpmjs.com

Instalación

bash
# npm
npm install @securestamp/sdk

# pnpm
pnpm add @securestamp/sdk

# yarn
yarn add @securestamp/sdk

Autenticación

typescript
import { SecureStamp } from '@securestamp/sdk'

const client = new SecureStamp({
  apiKey: process.env.SS_API_KEY, // ss_live_...
})

Uso básico

typescript
// Verify a domain
const result = await client.trust.check({ target: 'example.com' })

console.log(result.state)       // 'trusted' | 'suspicious' | 'blocked'
console.log(result.trustScore)  // 0–100
console.log(result.signals)     // SPF, DKIM, DMARC, ...

// Verify an email
const emailResult = await client.trust.check({ target: 'ceo@example.com' })

Respuesta

json
{
  "target": "example.com",
  "type": "domain",
  "state": "trusted",
  "trustScore": 87,
  "signals": {
    "spf": { "pass": true, "record": "v=spf1 include:_spf.google.com ~all" },
    "dkim": { "pass": true },
    "dmarc": { "pass": true, "policy": "reject" },
    "mxReputation": { "pass": true },
    "spamhausZen": { "listed": false }
  },
  "checkedAt": "2026-06-02T10:30:00.000Z"
}

Nunca expongas tu API key en frontend. Usala solo desde server-side, CLIs o entornos controlados.

REST APIcurlFull reference

POST /api/trust/check

curl
curl -X POST https://securestamp.online/api/trust/check \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ss_live_..." \
  -d '{"target":"example.com"}'
SDK — SecureStamp.store | SecureStamp.store