Helium Explorer
相信擁有礦機的人,對於官方
Helium Explorer並不陌生,只要輸入自己的礦機名字,就能在地圖中找到他的活動記錄、以及收益狀態等等。同時,在礦機名字下方,有兩串很長的英文名字,分別為:
1. 礦機代號
2. 礦機持有者代號
這兩個代號,對人眼來說沒有什麼意義,但在API中查詢,卻是必要的一部分。按代號右邊的小圖示,可以複製整串下來。
什麼是API?
API是官方提供的另一種查詢方式,不同於
Helium Explorer以網頁呈現;所查到的資料為純文字,對於需要整理成表格做統計,或是以程式做分析,都相當方便好用。而API的說明網頁如下:
https://docs.helium.com/api/
使用API查詢礦機
GET https://api.helium.io/v1/hotspots/:address
其中GET為取得網頁的方式,與直接在網址列輸入相同。所以後面的提供網址,可以直接在網址列使用。而:address所要填上的數值,則是在
Helium Explorer中所找到的自己的礦機代號:
https://api.helium.io/v1/hotspots/11Qj7Fgw4EqWgmAv9ckpLKjKjEbEtiik8BCfUxB2GvrvG2mdmyJ
在網址列輸入以上的網址,就可以得到礦機資料,而資料以json的方式呈現。
{"data":{"speculative_nonce":2,"lng":113.94326950553108,"lat":22.601565895318032,"timestamp_added":"2021-12-10T06:22:34.000000Z","status":{"timestamp":"2022-03-29T05:58:16.113000Z","online":"online","listen_addrs":["/ip4/119.13.91.222/tcp/44158","/p2p/112wDtEbpJWgw91911rzfS4AiqpKUTw2zqJxH282bXME5wzBn5Ur/p2p-circuit/p2p/11Qj7Fgw4EqWgmAv9ckpLKjKjEbEtiik8BCfUxB2GvrvG2mdmyJ"],"height":1287348},"reward_scale":0.8250885009765625,"payer":"13v9iGhjvQUtVaZXcFFRCEbL1nPR4R8QJowBgMUcaGM2v1aV6mn","owner":"14Sk3G62qC7MJXz2WtrPfSv4S3XCRbmbMSxqhoifJdMDr1pAzey","nonce":2,"name":"rapid-onyx-sparrow","mode":"full","location_hex":"88411ca891fffff","location":"8c411ca8901e9ff","last_poc_challenge":1289451,"last_change_block":1289483,"geocode":{"short_street":"Nanshan","short_state":"Guangdong Province","short_country":"CN","short_city":"Shenzhen","long_street":"Nanshan","long_state":"Guangdong Province","long_country":"China","long_city":"Shenzhen","city_id":"c2hlbnpoZW5ndWFuZ2RvbmcgcHJvdmluY2VjaGluYQ"},"gain":30,"elevation":0,"block_added":1133296,"block":1289522,"address":"11Qj7Fgw4EqWgmAv9ckpLKjKjEbEtiik8BCfUxB2GvrvG2mdmyJ"}}
- name:礦機名字
- short_city:所在地
- gain:天線增益
- elevation:天線高度
- address:礦機代號
- owner:礦機持用者代號
其餘欄位,也都各自可以找到相對應的用途。
以上,便是使用API查詢一台礦機的方式。