Documentation API

Guide de test API et environnement Sandbox

Maîtrisez les tests avec l'environnement Sandbox complet de Smart Money API. Développez sans risque en utilisant des données de test réalistes, des réponses déterministes et des limites de taux généreuses pour l'expérimentation.

Publié le 21 mars 2026 • 14 min de lecture • Développement

Aperçu de l'environnement Sandbox

Smart Money API fournit un environnement Sandbox complet pour le développement et les tests. Le Sandbox reflète la structure de l'API de production mais utilise des données synthétiques et des limites de taux généreuses, vous permettant de développer en toute confiance avant la mise en production.

Caractéristiques clés :

  • Identique à la production — Mêmes points de terminaison, authentification, format de réponse
  • Données de test uniquement — N'affecte jamais les comptes réels ou les marchés en direct
  • Limites de taux élevées — 10 000 requêtes/heure contre 1 000 en production
  • Réponses déterministes — Données de test cohérentes pour des tests reproductibles
  • Comptes isolés — Séparés des données utilisateur de production

Bonnes pratiques : Tous les développements, tests et mises en préproduction doivent utiliser l'environnement Sandbox. N'utilisez la production qu'après une validation approfondie dans le Sandbox.

Fonctionnalités du Sandbox

Données de test réalistes

Le Sandbox contient des données de marché cryptographiques réalistes qui ne changent pas aléatoirement :

  • Données de marché historiques (6 mois de données OHLCV réalistes)
  • Adresses de portefeuilles de baleines fixes avec des mouvements cohérents
  • Taux de financement stables qui se réinitialisent toutes les heures
  • Modèles de liquidation déterministes pour tester les cas limites

Fonctionnalités spécifiques aux tests

Fonctionnalités de test
// Symboles de test déterministes
// Tous les symboles de test commencent par TEST_
TEST_BTC, TEST_ETH, TEST_SOL, etc.
// Horodatages magiques pour simuler des scénarios
GET /v1/derivatives/funding-heatmap?
timestamp=1234567890000 // Renvoie des données de test fixes
// Forcer des erreurs pour tester la gestion des exceptions
X-Test-Error: rate_limit_exceeded
X-Test-Error: service_unavailable

Utilitaires de test

  • Réinitialisation des données — Réinitialise tous les comptes de test à leur état initial
  • Contrôle du temps — Simule différentes conditions de marché
  • Injection d'erreurs — Force des réponses d'erreur spécifiques
  • Test des limites de taux — Déclenche des réponses de limite de taux
Obtenez votre clé API en 30 secondes

Prêt à construire ? Obtenez une clé API gratuite (200 appels/jour, sans carte) et commencez à récupérer des données en direct sur les baleines, le financement et la blockchain.

Obtenez votre clé API →

Identifiants de test

Obtention de clés API de test

Créez un compte de test via le tableau de bord pour générer des clés API Sandbox :

Format des clés de test
// Les clés de test ont un préfixe différent
sk_test_1234567890abcdef // Clé API de test
sk_live_1234567890abcdef // Clé API de production
// Route automatiquement vers l'environnement approprié
GET https://api.smartmoneyapi.com/v1/whales
-H "Authorization: Bearer sk_test_xxx"
# Route automatiquement vers le Sandbox

Clés de test préconfigurées

Utilisez ces clés de test publiques pour une expérimentation rapide (limitées en taux) :

Clé Permissions Limite
sk_test_demo Lecture seule 100/heure
sk_test_trader Lecture + alertes 500/heure
sk_test_pro Accès complet 5000/heure

N'utilisez jamais les clés de test en production. Elles ont des fonctionnalités et des limites de taux limitées.

Données et fixtures de test

Symboles de test disponibles

Le Sandbox inclut ces paires de trading de test avec des données historiques réalistes :

Symboles de test
// Paires de cryptomonnaies
TEST_BTCUSDT, TEST_ETHUSDT, TEST_BNBUSDT
TEST_SOLSDT, TEST_ARBUSDT, TEST_OPUSDT
// Interroger les symboles de test
GET /v1/symbols?test_only=true

Portefeuilles de baleines de test

Portefeuilles de test préconfigurés avec un comportement déterministe :

  • Portefeuille accumulateur — Achete constamment, idéal pour les tests haussiers
  • Portefeuille distributeur — Vend constamment, idéal pour les tests baissiers
  • Portefeuille oscillateur — Alterne achat/vente, idéal pour les tests en range
  • Portefeuille volatilité — Transactions aléatoires importantes pour les tests de stress

Réinitialisation des données de test

Réinitialiser les données de test
// Réinitialise tous les comptes de test à leur état initial
POST /v1/test/reset
-H "Authorization: Bearer sk_test_xxx"
// Réinitialiser une ressource spécifique
POST /v1/test/reset?resource=whales
// Réponse
{
"status": "reset_complete",
"timestamp": 1709980800000
}

Points de terminaison Sandbox

URLs de base

URLs d'environnement
// Sandbox (mode test)
https://api-test.smartmoney.io/v1
// Ou utilisez le paramètre de requête
https://api.smartmoneyapi.com/v1?environment=sandbox
// Production (mode live)
https://api.smartmoneyapi.com/v1

Points de terminaison réservés au Sandbox

Point de terminaison Objectif
POST /test/reset Réinitialiser les données de test à l'état initial
POST /test/inject-error Injecter une erreur spécifique pour les tests
POST /test/simulate-time Simuler différentes conditions de marché
GET /test/status Vérifier l'état de santé de l'environnement sandbox

Simulation de réponses

Injection d'erreurs de test

Forcer des réponses d'erreur spécifiques pour tester la gestion des exceptions :

Injection d'erreur
// Tester la gestion des limites de taux
GET /v1/whales?X-Test-Error=rate_limit_exceeded
// Tester l'indisponibilité du service
GET /v1/whales?X-Test-Error=service_unavailable
// Tester un échec d'authentification
GET /v1/whales?X-Test-Error=invalid_key
// Tester un délai d'expiration
GET /v1/whales?X-Test-Error=timeout

Erreurs de test disponibles

Code d'erreur Statut HTTP Cas d'utilisation
invalid_key 401 Gestion des erreurs d'authentification
rate_limit_exceeded 429 Test de logique de backoff
not_found 404 Gestion des ressources manquantes
service_unavailable 503 Test de logique de réessai
timeout 504 Gestion des délais d'expiration

Limites de taux Sandbox

Niveaux de limites de taux

Environnement Limite/Heure Burst Objectif
Sandbox 10,000 500/min Développement & tests
Production Gratuite 1,000 50/min Projets personnels
Production Trader 10,000 400/min Trading professionnel
Production Pro 50,000 1000/min Systèmes à haute fréquence

Test de gestion des limites de taux

Test de limites de taux
// Déclencher une réponse de limite de taux dans le sandbox
curl -H "X-Test-Error: rate_limit_exceeded" \
https://api-test.smartmoney.io/v1/whales
// La réponse inclut des en-têtes de réessai
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709984400
Retry-After: 3600

Stratégies de test

Tests unitaires avec fixtures

Test unitaire Python
import unittest
import requests
class TestSmartMoneyAPI(unittest.TestCase):
def setUp(self):
self.api_key = 'sk_test_demo'
self.base_url = 'https://api-test.smartmoney.io/v1'
def test_whale_tracking(self):
response = requests.get(
f'{self.base_url}/whales/TEST_BTC',
headers={'Authorization': f'Bearer {self.api_key}'}
)
self.assertEqual(response.status_code, 200)
self.assertIn('whales', response.json())

Tests d'intégration

Tester le workflow complet dans le sandbox avant le déploiement en production :

  1. Déployer en staging avec les identifiants sandbox
  2. Exécuter la suite complète de tests contre le sandbox
  3. Tester la gestion des erreurs avec l'injection d'erreurs
  4. Vérifier le comportement des limites de taux
  5. Vérifier le temps de réponse et la latence
  6. Promouvoir ensuite en production

Tests de charge

Test de charge avec Apache Bench
// Le sandbox permet des tests de charge élevée
ab -n 5000 -c 100 \
-H "Authorization: Bearer sk_test_pro" \
https://api-test.smartmoney.io/v1/whales/TEST_BTC

Intégration CI/CD

Exemple GitHub Actions

.github/workflows/test.yml
name: API Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- run: pip install requests pytest
- env:
SMARTMONEY_API_KEY: ${{ secrets.TEST_API_KEY }}
SMARTMONEY_ENV: sandbox
run: pytest tests/

Configuration de l'environnement

Utilisez des variables d'environnement pour basculer entre le sandbox et la production :

Configuration de l'environnement
// .env.sandbox
SMARTMONEY_API_KEY=sk_test_demo
SMARTMONEY_API_URL=https://api-test.smartmoney.io/v1
SMARTMONEY_ENV=sandbox
// .env.production
SMARTMONEY_API_KEY=sk_live_xxxx
SMARTMONEY_API_URL=https://api.smartmoneyapi.com/v1
SMARTMONEY_ENV=production

Dépannage

Problèmes courants

Clé de test non fonctionnelle

Problème : Recevoir une erreur 401 Non autorisé avec la clé de test

Solutions :

  • Vérifiez que la clé commence par sk_test_ (et non sk_live_)
  • Vérifiez le format de l'en-tête Authorization : "Bearer sk_test_xxx"
  • Assurez-vous d'utiliser le point de terminaison de test : api-test.smartmoney.io
  • La clé de test peut avoir dépassé la limite de taux

Données non réinitialisées

Problème : Les données de test ne se réinitialisent pas après POST /test/reset

Solutions :

  • La réinitialisation peut prendre jusqu'à 30 secondes pour se propager
  • Vérifiez l'état du sandbox avec GET /test/status
  • Vérifiez que vous utilisez la bonne clé API de test
  • Contactez le support si le problème persiste

Limites de taux dans le sandbox

Problème : Atteindre les limites de taux dans le sandbox (ne devrait pas se produire)

Solutions :

  • Vérifiez que vous utilisez la clé sk_test_pro (10 000/heure)
  • Vérifiez l'en-tête X-RateLimit-Remaining
  • Attendez la limite horaire ou utilisez un autre compte de test
  • Contactez le support pour une augmentation temporaire de la limite de taux

Commencez à tester aujourd'hui

Utilisez notre environnement sandbox complet pour un développement sûr et isolé. Données de test déterministes, limites de taux élevées et parité complète des fonctionnalités avec la production.

Obtenez des identifiants de test
Tous les plans incluent l'accès au sandbox. Aucun coût supplémentaire.

Ressources connexes

Guide d'authentification →

Authentification API et gestion des clés

Référence API REST →

Documentation complète des points de terminaison API

Codes d'erreur →

Gestion des erreurs et codes de réponse
Commencez gratuitement — 200 appels/jour, sans carte

Obtenez les flux de baleines, les financements, les intérêts ouverts et les données on-chain de 3 échanges via une seule API. Niveau gratuit, sans carte de crédit, mise à niveau à tout moment.

Commencez gratuitement →
Essayez la console API en direct → (aucun compte nécessaire)