Services publics

Le robinet du testnet

Le robinet du testnet est un moyen de recevoir des jetons du testnet-v1 dans un portefeuille donné.

Via l'API HTTP

Un autre moyen de recevoir des jetons du testnet-v16 est via un appel HTTP, en fournissant l'adresse de votre portefeuille dans le corps de la demande, simplement comme suit:

Text Only

curl -X POST -d '1H1GPLkoMGVUfxQcJgtjWTrKV1KJCQooEV5WxPMhP4Zjy' https://faucet.testnet.alephium.org/send

Veuillez noter que le robinet limite les demandes pendant quelques minutes.

API des nœuds et des explorateurs

Actuellement, les services API suivants sont maintenus. Notez que toutes les API sont limitées en taux pour éviter le spam.

https://wallet-v20.mainnet.alephium.org pour le mainnet avec le nœud (Doc)
https://wallet-v20.testnet.alephium.org pour le testnet avec le nœud v2.X (Doc)
https://backend-v113.mainnet.alephium.org pour le mainnet avec le backend de l'explorateur v1.13.X (Doc)
https://backend-v113.testnet.alephium.org pour le testnet avec le backend de l'explorateur v1.13.X (Doc)

Comme le projet est toujours en développement actif, toutes les API sont versionnées. En général, seules les dernières versions sont maintenues, mais toutes les mises à niveau des API seront annoncées à l'avance à la communauté.

Alias API

Nous maintenons les alias API suivants pour donner aux utilisateurs le temps de migrer de l'ancienne API.

Aliases actuels

https://wallet.mainnet.alephium.org Test -> https://wallet-v20.mainnet.alephium.org
https://wallet.testnet.alephium.org Test -> https://wallet-v20.testnet.alephium.org
https://mainnet-wallet.alephium.org Test -> https://wallet-v20.mainnet.alephium.org
https://testnet-wallet.alephium.org Test -> https://wallet-v20.testnet.alephium.org
https://backend.mainnet.alephium.org Test -> https://backend-v113.mainnet.alephium.org
https://backend.testnet.alephium.org Test -> https://backend-v113.testnet.alephium.org
https://mainnet-backend.alephium.org Test -> https://backend-v113.mainnet.alephium.org
https://testnet-backend.alephium.org Test -> https://backend-v113.testnet.alephium.org
https://explorer.mainnet.alephium.org Test -> https://explorer-v113.mainnet.alephium.org
https://explorer.testnet.alephium.org Test -> https://explorer-v113.testnet.alephium.org
https://explorer.alephium.org Test -> https://explorer-v113.mainnet.alephium.org
https://wallet-v17.testnet.alephium.org Test -> https://explorer-v113.testnet.alephium.org

Alias obsolètes

https://wallet-v17.mainnet.alephium.org Test -> https://explorer-v113.mainnet.alephium.org
https://testnet.alephium.org Test -> https://explorer-v113.testnet.alephium.org

Import API Aliases

TypeScript

import aliases from "./api-aliases.json";

export const Aliases = ({aliases, type}) => (
    <Box>
        {aliases.length > 0 && <h3>{type} Aliases</h3>}
        <ul>{aliases && aliases.map((alias) => {
            const from = alias['from'];
            const to = alias['to'];
            const additionalPath = from.includes('wallet') ? '/infos/version' : from.includes('backend') ? '/infos' : '';
            return <li key={from}><code>{from}</code> (<a href={`${from}${additionalPath}`}>Test</a>) -> <code>{to}</code></li>;
        })}</ul>
    </Box>
)

<Aliases aliases={aliases['current']} type='Current' />
<Aliases aliases={aliases['deprecated']} type='Deprecated' />

Limitation du taux de l'API

Pour garantir les meilleures performances et la sécurité, toutes nos API publiques ont mis en place une limitation du taux. Cela signifie qu'il existe une limite sur le nombre de demandes que vous pouvez effectuer dans une certaine période de temps. À mesure que nos services évoluent et se développent, la limite de taux peut être ajustée en fonction de l'utilisation réelle du service.

Pour garantir une expérience fluide tout en travaillant dans la limite de taux, nous recommandons vivement de mettre en œuvre des mécanismes de mise en cache et de réessai lors de l'envoi de demandes à nos services API. La mise en cache des réponses peut aider à réduire le nombre d'appels API, tandis que la réessai des demandes échouées peut gérer les problèmes ou erreurs temporaires.

Si votre application est construite avec le framework React, vous pouvez tirer parti du package "SWR" disponible sur npm. SWR fournit des hooks pratiques pour le fetching et la mise en cache des données, facilitant ainsi le travail avec les API. Vous pouvez spécifiquement utiliser le hook useSWR pour la gestion des données mutables et le hook useSWRImmutable pour la gestion des données immuables telles que les métadonnées des jetons.