🧪 Staging Integration Guide

Qu'est-ce que l'environnement staging ?

Le staging est une copie entièrement fonctionnelle de l'API SoWasIt, dédiée à tester votre intégration avant de connecter la production. Vous pouvez créer des chaînes, ajouter des blocs, tester vos webhooks et clés API — gratuitement, sans impact sur vos données de production.

Démarrage rapide (3 minutes)

1. Créez un compte gratuit sur le staging

Inscrivez-vous à l'URL staging ci-dessous. Votre compte staging est séparé de votre compte de production.

2. Générez une clé API

Allez dans Tableau de bord → Clés API → Créer une clé. Copiez votre clé API staging — elle ne sera affichée qu'une seule fois.

3. Faites votre premier appel API

Créez votre première chaîne :

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

C'est tout. Vous avez maintenant une chaîne blockchain sur le staging. Ajoutez des blocs, testez les webhooks, construisez votre intégration.

Exemples de code

La seule chose qui change entre le staging et la production est l'URL de base et votre clé API. Voici des exemples prêts à l'emploi :

cURL

# Create a chain
curl -X POST https://api.staging.sowasit.io/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/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/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';

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

Politique de rétention des données

Les données de staging sont automatiquement nettoyées chaque nuit à 02h00 UTC. Cela maintient l'environnement léger et gratuit pour tous.

Besoin de repartir de zéro ? Vous pouvez supprimer vos chaînes manuellement depuis le tableau de bord, ou simplement attendre le nettoyage nocturne.

Passer en production

La migration du staging vers la production nécessite exactement deux modifications dans votre code :

Les deux modifications

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

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

Liste de contrôle avant lancement

• ✅ Tous les appels API retournent les réponses attendues en staging
• ✅ Les endpoints webhook sont validés et reçoivent les événements
• ✅ La gestion des erreurs testée (clé invalide, quota dépassé, etc.)
• ✅ Clé API de production créée et stockée de manière sécurisée
• ✅ URL de base mise à jour vers api.sowasit.io