May 8, 2025

API Brickken v1.0.1 – Mise à jour majeure

Chez Brickken, nous nous engageons à aider les entreprises à tokeniser les actifs du monde réel (RWA) via une infrastructure transparente et conviviale pour les développeurs. Avec la sortie de la version 1.0.1 de l'API, nous introduisons de nouvelles fonctionnalités qui vous permettent de mieux gérer les cycles de vie de la tokenisation, y compris la création de STO, l'intégration des investisseurs et la gestion des documents, tout en renforçant la cohérence et la clarté dans l'ensemble de l'API.

Plongeons-nous dans les nouveautés, les améliorations et la manière dont ces changements peuvent dynamiser votre expérience de tokenisation.

🚀 Nouveaux points de terminaison

✅ PATCH /patch-api-token-docs

Ce point de terminaison fournit une solution indispensable aux administrateurs de jetons pour mettre à jour les documents clés liés aux jetons par programmation. Il est parfait pour les projets souhaitant télécharger ou mettre à jour :

  • Logo du jeton : fichier JPEG ou PNG téléchargé sur S3.
  • Contrat d'abonnement : PDF juridique téléchargé sur IPFS.
  • Documentation juridique : documents PDF supplémentaires (conditions, avis de non-responsabilité, etc.), également téléchargés sur IPFS.

En gérant à la fois les documents de marque et de conformité, ce point de terminaison boucle la boucle des besoins de documentation post-tokenisation.

🔐 Nécessite une clé x-api valide.

📝 Type de formulaire : multipart/form-data.

📊 OBTENIR /get-api-stos

Récupérez toutes les offres de jetons de sécurité (STO) associées à un jeton donné via son tokenSymbol. Ce point de terminaison permet d'accéder aux tableaux de bord STO, aux analyses d'investissement et aux résumés de portefeuille.

Rendements :

  • Plafonds de jetons
  • Limites d'investissement
  • Statut STO (À VENIR, ACTIF, TERMINÉ)
  • Devise de paiement acceptée (par exemple, USDC)
  • Dates de début et de fin

Idéal pour le suivi de projet en temps réel ou les panels de relations avec les investisseurs.

🔍 GET /get-api-sto-by-id/{id}

Besoin de détails sur une offre spécifique ? Ce point de terminaison vous permet d'interroger n'importe quel STO par UUID et de renvoyer des informations complètes, notamment :

  • Nom de l'offre
  • Prix du jeton
  • Plafond dur/souple
  • Limites min/max par investisseur
  • Dates et modes de paiement

Parfait pour les flux d'intégration, les contrôles de conformité ou les rapports d'avancement.

🔄 Améliorations apportées aux points de terminaison existants

🔧 POST /prepare-api-transactions

Ce point de terminaison génère des transactions non signées pour les actions liées à la tokenisation. Dans la version 1.0.1, nous avons étendu ses capacités avec :

🆕 Nouvelle méthode prise en charge : newSto

Ajout de fonctionnalité majeur, cette méthode permet aux développeurs de préparer des transactions pour le lancement d’offres de jetons de sécurité directement depuis le backend.

Paramètres désormais acceptés pour newSto :

  • tokenizerEmail : Qui a créé le jeton
  • tokenAmount : Combien de jetons sont offerts
  • offeringName : Nom interne ou destiné aux investisseurs
  • startDate / endDate : Fenêtre d’investissement limitée dans le temps
  • acceptedCoin : Devise acceptée pour l’investissement (USDT, USDC, etc.)
  • minRaiseUSD / maxRaiseUSD : Plafond souple et plafond dur
  • minInvestment / maxInvestment : Limites par investisseur
  • signerAddress : Portefeuille du propriétaire du jeton

Ces champs permettent de construire hors chaîne un STO entièrement personnalisable et indépendant de la chaîne, et de le signer en toute sécurité avant la soumission.

📤 POST /send-api-transactions

Ce point de terminaison est utilisé pour envoyer des transactions signées à la blockchain et au backend Brickken. Dans la version 1.0.1, nous l'avons rendu plus intelligent et plus robuste :

  • ✅ Prise en charge complète de la méthode newSto
  • ✅ Validation améliorée lors de l'utilisation de jetons tels que BKN, USDT, USDC — une adresse tokenizerAddress valide est désormais requise pour les approbations
  • ✅ Soumission sensible à l'ordre pour les flux composés (par exemple, liste blanche avant la frappe)

💡 Conseil : si vous envoyez un lot comme [whitelistUser1, mintUser1], [whitelistUser2, mintUser2]... assurez-vous que votre tableau de transactions est ordonné en conséquence.

🧼 Autres améliorations et Améliorations

Nous avons également amélioré l'API pour la rendre plus facile à utiliser :

✍️ Documentation et clarté

  • Introduction de sections réductibles spécifiques aux méthodes dans l'interface utilisateur de Swagger
  • Élargissement de toute la documentation des méthodes pour clarifier l'intention, le contexte et les conditions préalables
  • Exemples améliorés dans les corps de requête et les réponses

🔐 Sécurité et Cohérence

  • Structures de schéma standardisées pour tous les corps de requête
  • Ajout de la validation manquante et de contrôles plus stricts dans les flux d'approbation

🧪 Meilleure expérience développeur

  • Tous les exemples de valeurs correspondent désormais à des scénarios d'utilisation réalistes
  • Descriptions plus précises pour les cas limites et les champs facultatifs

🔗 Où accéder

L'API Brickken est disponible dans deux environnements :


📨 Notes finales

Cette version est un tremplin vers des fonctionnalités encore plus avancées autour de l'automatisation du cycle de vie des jetons, des flux d'investisseurs et de l'émission STO conforme. Nous sommes extrêmement reconnaissants envers la communauté des développeurs pour leurs commentaires qui ont conduit à cette version, et nous travaillons déjà sur la suite.

Vous avez des questions ou besoin d'aide pour intégrer les nouvelles fonctionnalités ?

📩 Contactez-nous à l'adresse [email protected]

Restez connecté, l'équipe technique Brickken