La problématique

Aujourd'hui nous allons regarder de plus près certaines API concernant l'environnement du Bitcoin, cette monnaie virtuelle. Pour celles et ceux qui, tout comme moi ne connaissent pas forcement cet univers, je vous recommande la lecture de cette page qui fournit de belles explications sur le sujet : https://blockchainfrance.net/blockchain-pour-les-nuls/

Le service interrogé : blockchain.info

blockchain.ino est un site web qui apporte à l'utilisaateur des tas d'informations sur l'univers de la crypto-monnaie Bitcoin. Nous allons nous concentrer sur 3 actions, 3 services blockchain.info peut nous rendre :

• La conversion de monnaies
• La liste des valeurs en monnaies fiduciaires d'un Bitcoin
• D'autres API plus anectdotiques via plusieurs méthodes existent :
  • Temps réel :
    • getdifficulty - Cible de difficulté actuelle sous forme de nombre décimal
    • getblockcount - Taille actuelle du bloc dans la plus longue chaîne
    • latesthash - Hachage du dernier bloc
    • bcperblock - Récompense de bloc actuelle en BTC
    • totalbc - Total des Bitcoins en circulation (avec un retard d'une heure au maximum])
    • probability - Probabilité de trouver un bloc valide à chaque tentative de hachage
    • hashestowin - Nombre moyen de tentatives de hachage nécessaires pour résoudre un bloc
    • nextretarget - Bloquer la hauteur de la prochaine difficulté recibler
    • avgtxsize - Taille moyenne des transactions pour les 1000 derniers blocs. Modifiez le nombre de blocs en passant un entier comme second argument, par ex. avgtxsize / 2000
    • avgtxvalue - Valeur de transaction moyenne (1000 par défaut)
    • interval - temps moyen entre les blocs en secondes
    • eta - temps estimé jusqu'au bloc suivant (en secondes)
    • avgtxnumber - Nombre moyen de transactions par bloc (100 par défaut)
  • Recherche d'adresses
    • getreceivedbyaddress/Address - Obtenez le nombre total de bitcoins reçus par une adresse (en satoshi). Plusieurs adresses séparées par | Ne pas utiliser pour traiter des paiements sans le paramètre de confirmation
    • Ajoutez les paramètres start_time et end_time pour limiter les informations reçues à une période donnée. Les temps fournis devraient être un horodatage Unix en millisecondes. Plusieurs adresses séparées par |
    • getsentbyaddress/Address - Obtenez le nombre total de bitcoins envoyés par une adresse (en satoshi). Plusieurs adresses séparées par | Ne pas utiliser pour traiter des paiements sans le paramètre de confirmation
    • addressbalance/Address - Récupère le solde d'une adresse (en satoshi). Plusieurs adresses séparées par | Ne pas utiliser pour traiter des paiements sans le paramètre de confirmation
    • addressfirstseen/Address - Horodatage du bloc où une adresse a été confirmée pour la première fois.
  • Recherche de transactions :
    • txtotalbtcoutput / TxHash - Récupère la valeur de sortie totale d'une transaction (en satoshi)
    • txtotalbtcinput / TxHash - Récupère la valeur d'entrée totale d'une transaction (en satoshi)
    • txfee / TxHash - Obtenir les frais inclus dans une transaction (en satoshi)
    • txresult / TxHash / Address - Calcule le résultat d'une transaction envoyée ou reçue à Address. Plusieurs adresses séparées par |
  • Outils
    • addresstohash / Address - Convertit une adresse bitcoin en un hachage 160
    • hashtoaddress / Hash - Convertit un hachage 160 en adresse bitcoin
    • hashpubkey / Pubkey - Convertit une clé publique en un hachage 160
    • addrpubkey / Pubkey - Convertit une clé publique en adresse
    • pubkeyaddr / Address - Convertit une adresse en clé publique (si disponible)
  • Divers
    • unconfirmedcount - Nombre de transactions en attente non confirmées
    • 24hrprice - Prix pondéré sur 24 heures des plus grandes bourses
    • marketcap - Capitalisation boursière en USD (basée sur un prix pondéré sur 24 heures)
    • 24hrtransactioncount - Nombre de transactions au cours des dernières 24 heures
    • 24hrbtcsent - Nombre de btc envoyés au cours des dernières 24 heures (en satoshi)
    • hashrate - Taux de hachage réseau estimé en gigahash
    • rejected - Cherchez la raison pour laquelle le hachage de transmission ou de blocage fourni a été rejeté (le cas échéant)

Code PHP exemple

Bien évidemment, l'objet de cet article n'est pas de prendre les méthodes une à une et de les faire fonctionner mais bien de montrer un aperçu que les services web fournis, qui pourraient vous interesser.

Interval moyen entre deux blocs en secondes : <br>
590.844

Résultat

Nous allons ici, rechercher le nombre de bitcoins en circulation.

La problématique

Pour celles et ceux qui ne connaissent pas la notion de User-agent, l'user-agent d'un navigateur permet de connaitre les caractéristiques d'un navigateur. Très utile a l'epoque ou Internet Explorer nargait les normes des langages de création de sites web, ce User-agent permettait d'adapter le code javascript des pages en fonction des navigateurs. Encore utilisés à mon avis dans les bibliothèques javascript tel que JQuery, on est bien d'accord que nl'exemple que je montre là est bien pour la prouesse technique que pour son utilisation à proprement parler.

Le service interrogé

le service interrogé pour cet exemple est useragent.app, étonnant comme nom de service pour un service rertournant le user-agent. :-) Alors comment ca marche ? La première chose, après s'être identifié sur le site du webservice, L'URL contient les identifiant et accès au service. L'URL est de la forme :

https://api.useragent.app/parse?key=key&ua=ua

• key : clef API du service, fourni lors de votre enregistrement au service
• ua : C'est le user agent d'un navigateur

Le résultat

Nous allons regarder le résultat de cette API, avec une valeur de ua à Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36 (je n'ai pas utilisé pour ua la valeur du navigateur courant mais j'aurais pu) :

Et en PHP pour ceux que ça interesse :

<?php
    $key = 'VOTRE_CLEF_API_ICI';
    $ua = 'Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36';
    $ua = urlencode($ua);
    $raw = file_get_contents('https://api.useragent.app/parse?key=' . $key . '&ua=' . $ua);
    if (!$raw) {
       die('Parse error');
    }

   $result = json_decode($raw, true);
   include("XMLJSON2array/array2table.php");
   echo array2table($result, true, $null = ' ');
?>

La problématique :

Cette semaine, nous allons nous pencher sur une API peu commune et plutôt sympa pour les wabmaster développeurs de sites web : page2image. Bien que son nom parle de luimême, est il utile de rappeler que ce service et là pour vous fournir une copie d'écran de votre site web ? Alors oui, j'entends les puriste me répondre "ok pour la copie d'écran mais quel navigateur ? quel version ? quel système d'exploitation ? Et je ne peux qu'être d'accord avec vous, puriste du web, mais cette API n'est pas là pour vous afficher le résultat d'une page web sur différents OS/Browser (il y a des systèmes dédiés à cette fonctionnalité comme http://browsershots.org/ ou encore https://www.browserling.com pour ne citer qu'eux). Ici l'API est juste pour sortir une copie d'écran faite sur un "navigateur moderne". Afin de ne pas vexer la susceptibilité de chacun, je ne vous founirai pas les dernier tests ACID)

Le service interrogé : page2image

Ce service ne porte-t-il pas bien som nom ? Créer une copie d'écran de ce qui est affiché à un navigateur. A quoi cela peut servir ? Et bien certain annuaires web, en référençant leurs entrées, affichent un mini copie d'écran du site. Stocké en local sur le serveur, vous comprendez vite qu'avec cette API, les copies d'écran peuvent être dynamiques et donc... à jour !

Lorsque j'ai migré mon site Aujourd'hui à Nancy sur une plateforme CMS, quelques ANNEES plutard, j'ai retrouvé dans les annuaires des copie d'écran datant... de presque 10 ans. Et cela s'explique car une fois référencé dans ll'annuaire, le screenshot du site n'est JAMAIS remis à jour. Et désormais, vous avez toutes les clefs pour refaire une mise à jour de vos screenshots régulièrement, voire dynamiquement !

Dernière petite remarque que je destine tout particulièrement aux webmasters, ce webservice vous renvoie l'URL de la copie d'écran. Sympa pour la passer directement dans <img src="/...">

Un point positif à mentionner car c'est relativement rare mais bien pratique. Une fois que vous avez votre compte de créé et que vous vous êtes identifié au service, et que votre clef API est générée, rendez vous dans la partie API Generator, code wizard ou identifiez vous et cliquez sur mon lien. Une formulaire vous permet de générer les lignes de code (qui se mettent ensuite dans un lien de type <a href) et vous aurez un formulaire vous permettannt de prédéfinir vos options, dans parcourir toute la doc. Merci qui ? Sébatien, bien sûr (oui j'entends d'autres choses de là.... ).

ATTENTION : pour pouvoir faire fonctionner ce service, j'ai dû choisir l'onglet REST API Hard qui m'a renvoyé un JSON dans lequel l'URL de l'image est mentionnée, qui elle est correcte. Les autres systèmes proposés, je n'ai pas réussi à les faire fonctionner

Le résultat

Je ne peux vous proposer ici l'intégralité des services de ce services, mais je ne peux que vous renvoyer sur la documentation en anglais que je trouve claire (vous savez désormais que j'attache personnellement une grande importance à la documentation).

La problématique

Cette semaine, nous allons regarder une service web qui vous permet de connaitre en temps réel, enfin au moment du lancement de la requête http, le taux d'une monnaie. Le code effectué ici n'est pas actualisé en temps réel, mais je ne doute pas que vous avez les compétences AJAX afind e mettre en place cette façon de faire. Bon, il faiut quand même bien dire que le service interrogé mets en contrepartie des monnaies traditionnelles face aux nouvelles monnaies numériques. En effet, nous allons regarder le traditionnel Bitcoin, mais aussi l'Ethereum, pour ne citer que les deux crypto-monnaies les plus connues.

Le service interrogé : worldcoindex

Les API de WorldcoinIndex permettent d'interroger un webservice qui va vous renvoyer des informamtions monétaire sur les cryptomonnaies. Toujours pareil, nous n'allonspas voir toutes les fonctionnalités possibles, mais voyons ce que l'on peut faire. L'ensemble de la documentation est disponible à l'adresse :https://www.worldcoinindex.com/apiservice

Les méthodes utilisables sont :

• Ticker (telescripteur) : pemet de convertir une monnaie. 3 paramètres sont à passer dans l'url
  • key : c'est votre clef API que vous aurez demandé au préalable sur le site
  • label : nom, sigle de la monnaie d'origine et de destination. Utilise pour être réexploité ultérieurement
  • fiat=btc : sigle de la monnaie dans laquelle votre monnaie doit être retranscrite.

Voici un exemple fonctionnel : où je convertis une valeur en euros en cryptomonnaie

Il est aussi possible de sortir l'ensemble des transactions effectuées. Je vous ai créé un code exemple ci-dessous, voici le code PHP correspondant :

Code de l'exemple

<?php

setlocale (LC_TIME, 'fr_FR.utf8','fra');

function decimalNotation($num){
$parts = explode('E', $num);
if(count($parts) != 2){
return $num;
}
$exp = abs(end($parts)) + 3;
$decimal = number_format($num, $exp);
$decimal = rtrim($decimal, '0');
return rtrim($decimal, '.');
}
function json2array($x){
$t= file_get_contents($x);
return(json_decode($t, true));
}

$a = array();
$t=array();

echo "<pre>";
$a = json2array("https://www.worldcoinindex.com/apiservice/v2getmarkets?key=3GntouhJLf4BuwqgAMx6whxMsO4ywg&fiat=btc");
$t= $a["Markets"][0];
$c = count($a["Markets"][0]);

for ($i=0;$i<=count($a["Markets"][0])-1;$i++)
{
echo $i.". ".$t[$i]["Name"]." (".$t[$i]["Label"].") en date du ".date('l jS \of F Y h:i:s A',$t[$i]["Timestamp"])." vaut ".(float)$t[$i]["Price"]." bitcoin<br>";
}
print_r($t);
//echo "Label : ". $a["Markets"][0][0]["Label"];
echo "</pre>";
?>

Le résultat