🧪 Staging Integration Guide

¿Qué es el entorno de Staging?

Staging es una copia completamente funcional de la API de SoWasIt, dedicada a probar su integración antes de conectarse a producción. Puede crear cadenas, agregar bloques, probar sus webhooks y claves API, todo de forma gratuita, sin impacto en sus datos de producción.

Inicio Rápido (3 minutos)

1. Cree una cuenta gratuita en staging

Regístrese en la URL de staging a continuación. Su cuenta de staging está separada de su cuenta de producción.

2. Genere una clave API

Vaya a Panel → Claves API → Crear clave. Copie su clave API de staging — solo se mostrará una vez.

3. Haga su primera llamada API

Cree su primera cadena:

curl https://api.staging.sowasit.io/v1/chains \
  -H "X-API-Key: YOUR_STAGING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"my-first-chain","name":"My First Chain"}'

Eso es todo. Ahora tiene una cadena de integridad en staging. Agregue bloques, pruebe webhooks, construya su integración.

Ejemplos de Código

Lo único que cambia entre staging y producción es la URL base y su clave API. Aquí hay ejemplos listos para usar:

cURL

# Create a chain
curl -X POST https://api.staging.sowasit.io/v1/chains \
  -H "X-API-Key: YOUR_STAGING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"my-chain","name":"My Chain","visibility":"private"}'

# Add a block
curl -X POST https://api.staging.sowasit.io/v1/chains/my-chain/blocks \
  -H "X-API-Key: YOUR_STAGING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data":{"event":"user_signed","userId":"u_123","timestamp":"2025-01-15T10:00:00Z"}}'

# Read blocks
curl https://api.staging.sowasit.io/v1/chains/my-chain/blocks \
  -H "X-API-Key: YOUR_STAGING_API_KEY"

JavaScript / Node.js

const API_KEY = 'YOUR_STAGING_API_KEY';
const BASE_URL = 'https://api.staging.sowasit.io/v1';

const headers = {
  'X-API-Key': API_KEY,
  'Content-Type': 'application/json',
};

// Create a chain
await fetch(`${BASE_URL}/chains`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ id: 'my-chain', name: 'My Chain' }),
});

// Add a block
const res = await fetch(`${BASE_URL}/chains/my-chain/blocks`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ data: { event: 'user_signed', userId: 'u_123' } }),
});
const block = await res.json();
console.log('Block hash:', block.hash);

Python

import requests

API_KEY = 'YOUR_STAGING_API_KEY'
BASE_URL = 'https://api.staging.sowasit.io/v1'
headers = {'X-API-Key': API_KEY, 'Content-Type': 'application/json'}

# Create a chain
requests.post(f'{BASE_URL}/chains', json={'id': 'my-chain', 'name': 'My Chain'}, headers=headers)

# Add a block
res = requests.post(
    f'{BASE_URL}/chains/my-chain/blocks',
    json={'data': {'event': 'user_signed', 'userId': 'u_123'}},
    headers=headers
)
print('Block hash:', res.json()['hash'])

Política de Retención de Datos

Los datos de staging se limpian automáticamente cada noche a las 02:00 UTC. Esto mantiene el entorno ágil y gratuito para todos.

¿Necesita empezar de cero? Puede eliminar sus cadenas manualmente desde el panel en cualquier momento, o simplemente esperar la limpieza nocturna.

Ir a Producción

Migrar de staging a producción requiere exactamente dos cambios en su código:

Los dos cambios

# Staging
const BASE_URL = 'https://api.staging.sowasit.io/v1';

# Production
const BASE_URL = 'https://api.sowasit.io/v1';

Lista de verificación previa al lanzamiento

• ✅ Todas las llamadas API devuelven las respuestas esperadas en staging
• ✅ Los endpoints de webhook están validados y recibiendo eventos
• ✅ Manejo de errores probado (clave inválida, cuota excedida, etc.)
• ✅ Clave API de producción creada y almacenada de forma segura
• ✅ URL base actualizada a api.sowasit.io/v1