Hər HeroMiners hovuzu eyni yalnız oxumaq üçün HTTP endpointlərinə cavab verir. Açar, hesab və qeydiyyat yoxdur: URL sorğulayırsınız və JSON alırsınız; Access-Control-Allow-Origin: * təyin olunub, ona görə brauzerdəki səhifə onu birbaşa çağıra bilər. Ondan rig monitoru, ödəniş bildiricisi, öz idarə paneliniz qurmaq və ya hovuz məlumatlarını cədvələ çəkmək üçün istifadə edin.
Ünvanınızı daxil edin və aşağıdakı hər nümunə bu hovuzda işə salınmağa hazır olacaq. Burada yazdığınız heç nə hovuzun özündən başqa heç yerə göndərilmir və yalnız İşə sal düyməsini basdıqda göndərilir.
Əsas URL
https://quantus.herominers.com
Endpointlər
GET/api/stats
Hovuzun hazırda özü haqqında bildiyi hər şey: hovuz və şəbəkə heş sürəti, qoşulmuş maynerlər və işçilər, son blok, komissiyalar, portlar və ödəniş ayarları.
Parametr
address
Ödəniş ünvanı. Həmin mayneri miner altında, solo mayninq də edirsə, solo_miner altında əlavə edir. Göstərilməsə, heç bir açar göndərilmir.
Başlamaq üçün bu endpointdir. Hovuz səhifəsi, maynerlər səhifəsi və bu saytdakı hər qrafik ondan qurulur.
Sorğu
curl "https://quantus.herominers.com/api/stats"
Cavab
pool, network, config, charts, lastblock, payments və visitors (hazırda saytda neçə nəfərin olduğu, { windowMinutes, activeVisitors, activeLookups } şəklində) olan obyekt. Hər statistika dövründə bir dəfə yenidən hesablanır, ona görə daha tez sorğulamaq eyni rəqəmləri qaytarır.
GET/api/live_stats
/api/stats ilə eyni məlumat, lakin sorğu növbəti statistika dövrü bitənə qədər açıq saxlanılır, sonra cavablandırılır. Taymerlə sorğulamaq əvəzinə hər yeniləmə üçün bir sorğu.
Parametr
address
/api/stats kimi, cavaba mayner daxil edin.
Bir bağlantı açın və cavab gələndə onu yenidən açın. Eyni IP-dən eyni anda açıq bir neçə bağlantı 503 ilə rədd edilir, ona görə paralel sorğular göndərməyin.
Bunu işə salmaq üçün yuxarıda daxil edin: address. Əmr onu göstərir, çünki onsuz hovuz xəta ilə cavab verir.
Cavab
stats (maynerin cəmləri), payments, charts, unlocked və workers olan obyekt; sonuncu hər işçi üçün bir element olan massivdir, hər element name ilə adlanır. Burada heç vaxt mayninq etməmiş ünvan boş mayner yox, xəta cavabı alır.
GET/api/get_blocks
Hovuzun tapdığı və artıq gözləmədə olmayan bloklar: ödənilmiş və ya yetim. Hansı olduğunu status göstərir.
Parametr
heighttələb olunur
Bu hündürlükdən aşağı blokları qaytarır. Ən yeni səhifə üçün zəncirin ucundan xeyli yuxarı rəqəm verin, sonra geriyə səhifələmək üçün aldığınız ən aşağı hündürlüyü verin.
Tapanın ünvanı hovuzdan çıxmazdan əvvəl maskalanır, ona görə bu endpointlə ünvan toplamaq mümkün deyil. time Unix saniyələrindədir, reward koinin ən kiçik vahidindədir və solo blokun score dəyəri ödənildikdə s0, yetim olduqda s1 olur.
Hovuzun göndərdiyi ödənişlər, ya bütün hovuz üzrə, ya da bir ünvan üçün.
Parametr
timetələb olunur
Bu Unix vaxt damğasından (saniyə) əvvəlki ödənişləri qaytarır. Ən yeni səhifə üçün cari vaxtı, sonra geriyə səhifələmək üçün aldığınız ən köhnə vaxt damğasını istifadə edin.
address
Bir ödəniş ünvanı ilə məhdudlaşdırır. Hovuzun etdiyi bütün ödənişlər üçün göstərməyin.
limit
Neçəsinin qaytarılacağı. Hovuzun öz səhifə ölçüsü ilə məhdudlaşdırılır, ona görə daha böyük rəqəm sadəcə o qədərini qaytarır.
format
Xam massiv əvəzinə { tx, amount, time } obyektləri almaq üçün parsed verin.
conversions
address ilə birlikdə 1 verin ki, səhifədəki başqa koinə çevrilmiş hər ödənişin çevirmə qeydini də alasınız. Cavab o zaman { payments, conversions } olur. format=parsed ilə nəzərə alınmır.
format olmadan dəyər və vaxt damğasını növbələşdirən düz massiv, hər dəyər txid:amount şəklindədir. Məbləğlər koinin ən kiçik vahidində sətirlərdir və sətir olaraq qalmalıdır: 18 onluq rəqəmli zəncirdə onu ədəd kimi oxumaq dəqiqliyi itirir.
GET/api/get_miners_stats
Hovuzdakı ən böyük on mayner, həmçinin maynerlər səhifəsinin əsasında duran mayninq proqramları və regionlar üzrə bölgülər.
miners, agents, regions, regionHistory və statsDisplay olan obyekt. Ünvanlar maskalanıb. Panel aktiv deyilsə, onun massivi boş qayıdır və statsDisplay bunu bildirir.
GET/api/get_blocks_search
Hovuzun bloklarında hündürlük, blok heşi və ya tapanın ünvanı üzrə axtarış, gözləyən və ödənilmiş bloklarda eyni anda.
Parametr
qtələb olunur
Hündürlük, blok heşi və ya ünvan.
offset
Bu qədər nəticəni ötürür. Cavabda hasMore var ki, yenidən soruşmağın lazım olub-olmadığını biləsiniz.
Axtarış hər IP üçün məhdudlaşdırılıb və limiti aşdıqda sadə xəta əvəzinə retryMs daxilində dəqiq gözləmə müddəti ilə rateLimited qaytarılır. Uzunluq hədlərini və axtarışın ümumiyyətlə aktiv olub-olmadığını öyrənmək üçün əvvəlcə /api/get_blocks_search_config çağırın.
Bunu işə salmaq üçün yuxarıda daxil edin: q. Əmr onu göstərir, çünki onsuz hovuz xəta ilə cavab verir.
Cavab
pending və matured olan obyekt, hər ikisi /api/get_blocks kimi dəyər və hündürlüyü növbələşdirir, üstəgəl totalMatched, offset, limit və hasMore. matured blok /api/get_blocks formatındadır; pending blok hələ yetişməni gözləyir və daha uzun gözləmə formatını istifadə edir, ona görə sahələri fərqli ardıcıllıqdadır.
GET/api/get_blocks_search_config
Blok axtarışının aktiv olub-olmadığı və sorğunun uyğun gəlməli olduğu hədlər, ki axtarış qutusu ilk axtarışdan əvvəl qurulsun.
{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. Uzunluqlar simvollarladır, frontendCooldownMs isə iki axtarış arasında nə qədər gözləmək lazım olduğudur.
GET/api/get_miner_payout_level
Ünvan üçün hazırda təyin edilmiş ödəniş həddi, tam koinlərlə.
Parametr
addresstələb olunur
Ödəniş ünvanı.
Uyğun /api/set_miner_payout_level onu yazır və hamıya açıq deyil: sorğu ünvanın öz mayninq IP-sindən gəlməlidir. Bu yoxlama və ondan əvvəlki sorğu limiti burada deyil, idarə panelinin ayarlar tabında təsvir olunur.
Bunu işə salmaq üçün yuxarıda daxil edin: address. Əmr onu göstərir, çünki onsuz hovuz xəta ilə cavab verir.
Cavab
{ banned, minerMessage }, bloklandıqda isə əlavə olaraq blockMining, blockPayments və reason. Bu, mayner səhifəsinin bu ünvan üçün göstərdiyi bildirişdir: mayninqdən, ödəniş almaqdan bloklanıb və ya heç birindən. minerMessage operatorun bu ünvana mesajıdır, { message, type, createdAt, expiresAt } şəklində, yoxdursa null.
Düzgün istifadə
Hovuzun öz ritmi ilə sorğulayın. Rəqəmlər hər statistika dövründə bir dəfə yenidən hesablanır və /api/stats cavabındakı config.updateInterval bunun neçə saniyə olduğunu göstərir. Daha tez-tez soruşmaq eyni cavabı qaytarır və hər iki tərəfə trafik baha başa gəlir.
Sürətli taymer əvəzinə /api/live_stats seçin. Yeni bir şey olan kimi cavab verir; bu, sorğulamadan həm Sizin üçün daha sürətli, həm də hovuz üçün daha yüngüldür.
Məbləğləri sətir kimi saxlayın. Mükafatlar və balanslar koinin ən kiçik vahidində qayıdır. 18 onluq rəqəmli zəncirdə bu tam ədədlər JavaScript ədədinin dəqiq saxlaya biləcəyi həddi aşır, ona görə onu ədəd kimi oxumaq ödənişi xəbərsiz yuvarlaqlaşdırır.
Ünvanların maskalanacağını gözləyin. İctimai siyahılar hər ünvanın ortasını gizlədir. Tam ünvanınız yalnız Sizə lazımdır və yalnız onu özünüz verdiyiniz yerdə.
Sorğu limitini xəta deyil, gözləmə kimi qəbul edin. Limit tətbiq olunduqda cavabda retryMs olur. Sorğu yağdırmaq əvəzinə o qədər gözləyin və yenidən cəhd edin.
Kim olduğunuzu bildirin. Alətinizi adlandıran User-Agent tələb olunmur, lakin onun sayəsində nəyin sındığını təxmin etmək əvəzinə Sizə dəyişiklik barədə xəbər verə bilərik.