2022-03-30|閱讀時間 ‧ 約 5 分鐘

Helium API 查詢礦機

Helium Explorer

  相信擁有礦機的人,對於官方Helium Explorer並不陌生,只要輸入自己的礦機名字,就能在地圖中找到他的活動記錄、以及收益狀態等等。同時,在礦機名字下方,有兩串很長的英文名字,分別為:   1. 礦機代號   2. 礦機持有者代號 這兩個代號,對人眼來說沒有什麼意義,但在API中查詢,卻是必要的一部分。按代號右邊的小圖示,可以複製整串下來。
礦機查詢範例
礦機查詢範例

什麼是API?

  API是官方提供的另一種查詢方式,不同於Helium Explorer以網頁呈現;所查到的資料為純文字,對於需要整理成表格做統計,或是以程式做分析,都相當方便好用。而API的說明網頁如下:
https://docs.helium.com/api/

使用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"}}
列舉部分欄位如下,與Helium Explorer所看到的資料相同:
  • name:礦機名字
  • short_city:所在地
  • gain:天線增益
  • elevation:天線高度
  • address:礦機代號
  • owner:礦機持用者代號
其餘欄位,也都各自可以找到相對應的用途。
以上,便是使用API查詢一台礦機的方式。
分享至
成為作者繼續創作的動力吧!
© 2024 vocus All rights reserved.