Comment obtenir une clé API UniSat pour les développeurs ? (Outils de développement)

Accéder au portail des développeurs UniSat

1. Accédez au site Web officiel d'UniSat et localisez la section « Développeur » ou « API » dans le menu de navigation principal.

2. Cliquez sur le lien intitulé « Outils de développement » ou « Documentation API », qui redirige vers un sous-domaine ou un chemin dédié tel que https://dev.unisat.io .

3. Assurez-vous que votre navigateur ne bloque pas les cookies tiers, car le portail s'appuie sur une authentification basée sur la session pour la création de compte et la génération de clés.

4. Si vous n'avez pas encore installé d'extension de portefeuille UniSat, téléchargez-la et configurez-la à partir du Chrome Web Store ou des modules complémentaires Firefox avant de continuer.

5. Connectez-vous à l'aide de votre portefeuille UniSat — le système vérifie la propriété via une vérification de signature cryptographique plutôt que par des informations d'identification par e-mail/mot de passe.

Enregistrer une demande

1. Une fois authentifié, accédez à l'onglet « Applications » dans le tableau de bord du développeur.

2. Cliquez sur le bouton « + Nouvelle application » pour lancer l'inscription.

3. Saisissez un nom descriptif pour votre projet, tel que « Bitcoin NFT Explorer » ou « Ordinal Indexer Bot ».

4. Fournissez une URL de rappel valide — il doit s'agir d'un point de terminaison HTTPS où UniSat peut envoyer des notifications de webhook pour des événements tels que les confirmations d'inscription.

5. Sélectionnez les autorisations requises par votre application : accès en lecture seule aux données de la blockchain, récupération des métadonnées d'inscription ou capacités d'interaction complètes avec le portefeuille.

Génération et gestion de clés API

1. Après avoir soumis le formulaire de candidature, UniSat génère un identifiant client unique et l'affiche à côté d'une clé API secrète dans une fenêtre modale à usage unique.

2. Copiez immédiatement les deux valeurs : la clé secrète est masquée après la première visualisation et ne peut plus être récupérée depuis l'interface.

3. Stockez la clé secrète dans une variable d'environnement sécurisée ou dans un coffre-fort ; l'exposer dans le code frontend ou dans des référentiels publics compromet la sécurité de votre application.

4. Utilisez l'ID client comme en-tête X-Client-ID et la clé secrète comme en-tête X-API-Key lorsque vous effectuez des requêtes HTTP vers des points de terminaison tels que /v1/inscriptions ou /v1/transactions .

5. Révoquez les clés compromises via l'option « Révoquer la clé » dans les paramètres de l'application : la révocation prend effet dans les 60 secondes sur tous les nœuds de l'infrastructure UniSat.

Limites de débit et contraintes d'utilisation

1. Les applications gratuites sont limitées à 1 000 requêtes par heure avec des rafales plafonnées à 100 requêtes par minute.

2. Chaque clé API est liée à un ID d'application spécifique : tenter d'utiliser une clé sur plusieurs applications enregistrées déclenche une limitation automatique.

3. Les requêtes renvoyant le statut HTTP 429 indiquent que votre limite de débit actuelle a été dépassée ; les réponses incluent un en-tête Retry-After spécifiant les secondes jusqu'au prochain appel autorisé.

4. Les opérations groupées telles que la récupération de listes d'inscription dépassant 500 entrées nécessitent des paramètres de pagination ( limite et décalage ) — leur omission entraîne des réponses tronquées.

5. Tous les horodatages renvoyés par l'API suivent le format ISO 8601 avec le fuseau horaire UTC, et les valeurs de hauteur de bloc reflètent uniquement les blocs du réseau principal Bitcoin confirmés.

Foire aux questions

Q : Puis-je utiliser la même clé API UniSat sur plusieurs domaines ? R : Non. Chaque domaine doit être explicitement enregistré lors de la configuration de l'application. L'utilisation entre domaines déclenche le rejet de CORS et invalide la demande avant d'atteindre les services backend.

Q : UniSat prend-il en charge la rotation des clés API sans temps d'arrêt ? R : Oui. Générez une nouvelle clé pendant que l'ancienne reste active, mettez à jour la configuration de votre service, puis révoquez la clé précédente une fois que la vérification confirme un fonctionnement stable.

Q : Les inscriptions testnet sont-elles accessibles via l'API de production ? R : Non. L’API de production sert exclusivement les données du réseau principal. Un point de terminaison testnet distinct existe sur https://testnet-api.unisat.io , nécessitant son propre enregistrement d'application et sa propre clé.

Q : Que se passe-t-il si ma candidature dépasse les seuils de quota quotidien ? R : Les requêtes échouent avec HTTP 403 Forbidden et incluent un en-tête X-RateLimit-Remaining affichant zéro. Les quotas sont réinitialisés à minuit UTC, quels que soient les modèles d'utilisation.