🧪 Staging Integration Guide

Was ist die Staging-Umgebung?

Staging ist eine vollständig funktionsfähige Kopie der SoWasIt-API, die zum Testen Ihrer Integration vor dem Verbinden mit der Produktion bestimmt ist. Sie können Chains erstellen, Blöcke hinzufügen, Webhooks und API-Schlüssel testen — kostenlos, ohne Auswirkungen auf Ihre Produktionsdaten.

Schnellstart (3 Minuten)

1. Kostenloses Konto auf Staging erstellen

Registrieren Sie sich unter der Staging-URL unten. Ihr Staging-Konto ist von Ihrem Produktionskonto getrennt.

2. API-Schlüssel generieren

Gehen Sie zu Dashboard → API-Schlüssel → Schlüssel erstellen. Kopieren Sie Ihren Staging-API-Schlüssel — er wird nur einmal angezeigt.

3. Ersten API-Aufruf machen

Erstellen Sie Ihre erste Chain:

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"}'

Das war's. Sie haben jetzt eine Integritätskette auf Staging. Fügen Sie Blöcke hinzu, testen Sie Webhooks, bauen Sie Ihre Integration.

Codebeispiele

Das Einzige, was sich zwischen Staging und Produktion ändert, ist die Basis-URL und Ihr API-Schlüssel. Hier sind gebrauchsfertige Beispiele:

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'])

Datenspeicherungsrichtlinie

Staging-Daten werden jede Nacht um 02:00 UTC automatisch bereinigt. Das hält die Umgebung schlank und für alle kostenlos.

Brauchen Sie einen Neustart? Sie können Ihre Chains jederzeit manuell über das Dashboard löschen oder einfach auf die nächtliche Bereinigung warten.

In Produktion gehen

Die Migration von Staging zu Produktion erfordert genau zwei Änderungen in Ihrem Code:

Die zwei Änderungen

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

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

Checkliste vor dem Launch

• ✅ Alle API-Aufrufe geben die erwarteten Antworten auf Staging zurück
• ✅ Webhook-Endpunkte werden validiert und empfangen Ereignisse
• ✅ Fehlerbehandlung getestet (ungültiger Schlüssel, Kontingent überschritten, usw.)
• ✅ Produktions-API-Schlüssel erstellt und sicher gespeichert
• ✅ Basis-URL auf api.sowasit.io/v1 aktualisiert