Domenin tarixçəsi
Konkret PIVX adı üzərində aparılmış əməliyyatların (qeydiyyat və dəyişikliklər kimi) tarixçə jurnalını qaytarır.
Son nöqtə
POST https://indexer.pivx.name/v1.0/history/richard.pivx
Yol parametrləri
| Parametr | Tip | Məcburi | Təsvir |
|---|---|---|---|
domain_name | string | Bəli | Tarixçəsi sorğulanan PIVX domeni (məsələn, richard.pivx). |
Sorğunun gövdəsi
Sorğunun gövdəsi aşağıdakı parametrləri ehtiva edən JSON obyekti olmalıdır:
| Parametr | Tip | Susmaya görə | Təsvir |
|---|---|---|---|
count | integer | 100 | Qaytarılacaq ən çox sətir sayı, 500-ə qədər: daha böyük say 500-ə endirilir. |
from_block_id | integer | Yoxdur | Yalnız bu blokdan sonrakı sətirləri qaytarır: asc ilə sonrakı bloklardan, desc ilə əvvəlki bloklardan; blokun özü daxil deyil. Verilmədikdə siyahı ən köhnə sətirdən (asc) və ya ən yeni sətirdən (desc) başlayır. |
from_nonce | integer | Yoxdur | Yalnız from_block_id ilə birlikdə: sizdə olan son sətrin nonce dəyəri. Onda siyahı bütün blokdan sonra deyil, məhz həmin sətirdən sonra davam edir; bax: Səhifələmə. |
order | string | desc | Sıralama: asc və ya desc. Sətirlər əvvəlcə bloka, sonra nonce dəyərinə görə sıralanır. |
Kod nümunələri
- cURL
- JavaScript
- Python
- PHP
curl -X POST https://indexer.pivx.name/v1.0/history/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"count": 10,
"from_block_id": 5537000,
"order": "asc"
}'
const url = 'https://indexer.pivx.name/v1.0/history/richard.pivx';
const data = {
count: 10,
from_block_id: 5537000,
order: 'asc'
};
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
url = "https://indexer.pivx.name/v1.0/history/richard.pivx"
payload = {
"count": 10,
"from_block_id": 5537000,
"order": "asc"
}
headers = {
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
<?php
$url = 'https://indexer.pivx.name/v1.0/history/richard.pivx';
$data = [
'count' => 10,
'from_block_id' => 5537000,
'order' => 'asc'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
Cavab nümunəsi
{
"response": [
{
"domain_block_id": 5537326,
"domain_ts": 1784808285,
"target_address": "ps1f84lvgj0awz2yf2zha5d5gddhd4j88g0kzj5cwp776vhxp5fdjqe7e95cdx2qs5e7fcvg3ds3yq",
"owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
"domain_tx": "388241ffc5bf8ba3d7633d132298d157e26d6ac127ff8d162f26e7203084df08",
"op": "REG",
"nonce": 1784808228,
"price": 0
},
{
"domain_block_id": 5537369,
"domain_ts": 1784812590,
"target_address": "ps1f84lvgj0awz2yf2zha5d5gddhd4j88g0kzj5cwp776vhxp5fdjqe7e95cdx2qs5e7fcvg3ds3yq",
"owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
"domain_tx": "4d5419af400966616ba9325f78bb3cac2ff1229fd4d39ed022a9fc113ee4b67e",
"op": "LST",
"nonce": 1784812534,
"price": 200000
},
{
"domain_block_id": 5537421,
"domain_ts": 1784815647,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "3834eb36ca816f1bd9074c546ec64b3a361aca67e88c35b1586fe4ec1ae60095",
"op": "BUY",
"nonce": 1784815586,
"price": 0
},
{
"domain_block_id": 5538248,
"domain_ts": 1784878331,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "3c08640ed394b1a270abddcc3ca873c13793629c6a148ad0b5585003ca9e632a",
"op": "LST",
"nonce": 1784878114,
"price": 10012345678
},
{
"domain_block_id": 5538248,
"domain_ts": 1784878331,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "9ad75f893c002f21e9bbc3c6cdf4e151477293d64a013aa773db26598c1d5d11",
"op": "ULT",
"nonce": 1784878293,
"price": 0
}
]
}
| Sahə | Tip | Təsvir |
|---|---|---|
domain_block_id | int | Əməliyyatı saxlayan PIVX bloku |
domain_ts | int | Həmin blokun vaxtı, Unix saniyələri ilə |
target_address | string | Əməliyyatdan sonra adın həll olunduğu ünvan |
op | string | Əməliyyat: REG, UPD, CHG, LST, ULT və ya BUY |
owner_pubkey | string | Əməliyyatdan sonra ad sahibinin açıq açarı |
domain_tx | string | Bu əmri daşıyan PIVX əməliyyatının heşi |
nonce | int | Əməliyyatın nonce dəyəri: ad üzərində hər əməliyyatla artan vaxt möhürü |
price | int | Əməliyyatdan sonrakı satış qiyməti, satoshi ilə: LST üçün satışa çıxarılma qiyməti, əks halda 0. BUY sətri 0 göstərir, çünki ad artıq satışda deyil; ödənilən qiymət ondan əvvəlki son LST qiymətidir |
Səhifələmə
Uzun tarixçəni səhifə-səhifə oxumaq üçün hər səhifənin son sətrini kursor kimi geri göndərin: onun domain_block_id dəyərini from_block_id, nonce dəyərini isə from_nonce kimi. Hər ikisini göndərin: bir blok eyni ad üzərində bir neçə əməliyyat saxlaya bilər (yuxarıdakı nümunədə 5538248 blokundakı LST və ULT) və səhifə onların arasında bitə bilər. Yalnız from_block_id ilə növbəti səhifə növbəti blokdan başlayar və həmin blokun qalanını buraxardı. İstədiyinizdən (və ya daha çox istəmisinizsə, 500-dən) az sətri olan səhifə sonuncudur.
from_nonce, from_block_id olmadan göndərildikdə və ya mənfi olmayan tam ədəd olmadıqda, One or several params provided have wrong value xətası ilə cavablandırılır; mənfi və ya tam olmayan count da həmçinin.