Partez du contrat public, pas des charges utiles du fournisseur

Une intégration devrait dépendre du schéma de ChainsFlow API versionné plutôt que des formes de réponse Binance, Bybit, Kraken ou OKX. Le API maintient les DTO fournisseurs derrière les adaptateurs et expose des ressources stables pour les utilisateurs, les comptes, le solde et le portefeuille. Générez des clients typés à partir de OpenAPI lorsque cela est utile, mais gardez un petit enveloppe appartenant à l’application afin que les mises à jour de version et le mappage d’erreurs restent délibérés.

Conservez la propriété de l’utilisateur final dans votre BFF

Créez un portefeuille via POST /api/v1/portfolios et stockez le portfolioId opaque renvoyé avec votre utilisateur local. ChainsFlow API ne voit que le compte API authentifié et ses portefeuilles.

Considérez les connexions d’échange comme des ressources durables

Une connexion contient des identifiants chiffrés en lecture seule, l’état de synchronisation et les avoirs normalisés. Créez-la depuis votre serveur, conservez l’identifiant de compte renvoyé et présentez à l’utilisateur des états explicites : synchronisation, actif ou erreur. Ne faites jamais transiter les secrets de la plateforme par des outils d’analyse, d’assistance ou des journaux côté client, et prévoyez une action de suppression claire lorsque l’utilisateur déconnecte une plateforme.

Lisez des comptes et agrégez les vues pour différents emplois

Les endpoints de compte servent à consulter l’état du fournisseur, les soldes exacts et à gérer les connexions. L’endpoint de portefeuille combine les comptes pris en charge dans une vue unique en USD, avec répartition et variation implicite du marché sur 24 heures. Les performances restent distinctes, car elles dépendent des instantanés stockés et de la couverture des flux de trésorerie. Choisir l’endpoint le plus précis réduit la consommation de crédits et rend les états de chargement plus compréhensibles.

Ajoutez des budgets, de la visibilité et une dégradation élégante

Consignez X-Credit-Cost, X-Credits-Remaining et les identifiants de corrélation, jamais les secrets. Définissez des délais d’attente bornés, respectez Retry-After et distinguez une panne du fournisseur d’un échec d’authentification ou d’un manque de crédits. Ne mettez en cache que des données dont le produit peut expliquer l’ancienneté. L’écran du portefeuille doit rester utile lorsqu’une plateforme est temporairement indisponible, sans présenter tout l’espace de travail comme perdu.