Lịch sử tên miền
Trả về nhật ký các thao tác (như đăng ký và thay đổi) đã thực hiện trên một tên PIVX cụ thể.
Điểm cuối
POST https://indexer.pivx.name/v1.0/history/richard.pivx
Tham số đường dẫn
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
domain_name | string | Có | Tên miền PIVX cần tra lịch sử (ví dụ richard.pivx). |
Thân yêu cầu
Thân yêu cầu phải là một đối tượng JSON gồm các tham số sau:
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
count | integer | 100 | Số dòng tối đa trả về, tới 500: số lớn hơn bị cắt xuống 500. |
from_block_id | integer | Không có | Chỉ trả về các dòng sau khối này: từ các khối sau với asc, từ các khối trước với desc; bản thân khối này không được tính. Nếu không có, danh sách bắt đầu từ dòng cũ nhất (asc) hoặc mới nhất (desc). |
from_nonce | integer | Không có | Chỉ dùng cùng from_block_id: nonce của dòng cuối cùng bạn đang có. Khi đó danh sách tiếp tục ngay sau dòng đó, chứ không phải sau cả khối của nó; xem Phân trang. |
order | string | desc | Thứ tự sắp xếp: asc hoặc desc. Các dòng được sắp theo khối, rồi theo nonce. |
Ví dụ mã
- 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);
Ví dụ phản hồi
{
"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
}
]
}
| Trường | Kiểu | Mô tả |
|---|---|---|
domain_block_id | int | Khối PIVX chứa thao tác |
domain_ts | int | Thời gian của khối đó, tính bằng giây Unix |
target_address | string | Địa chỉ mà tên phân giải tới sau thao tác |
op | string | Thao tác: REG, UPD, CHG, LST, ULT hoặc BUY |
owner_pubkey | string | Khóa công khai của chủ sở hữu tên sau thao tác |
domain_tx | string | Băm của giao dịch PIVX mang thao tác này |
nonce | int | Nonce của thao tác: một dấu thời gian tăng theo mỗi thao tác trên tên |
price | int | Giá bán sau thao tác, tính bằng satoshi: giá niêm yết với LST, ngược lại là 0. Dòng BUY hiển thị 0 vì tên không còn được rao bán; giá đã trả là giá của LST gần nhất trước nó |
Phân trang
Để đọc một lịch sử dài theo từng trang, hãy gửi lại dòng cuối của mỗi trang làm con trỏ: domain_block_id của nó làm from_block_id và nonce của nó làm from_nonce. Hãy gửi cả hai: một khối có thể chứa nhiều thao tác trên cùng một tên (trong ví dụ trên là LST và ULT ở khối 5538248), và một trang có thể kết thúc ở giữa chúng. Chỉ với from_block_id, trang sau sẽ bắt đầu từ khối kế tiếp và bỏ qua phần còn lại của khối đó. Trang có ít dòng hơn số bạn yêu cầu (hoặc ít hơn 500, nếu bạn yêu cầu nhiều hơn) là trang cuối.
Một from_nonce không kèm from_block_id, hoặc không phải số nguyên không âm, sẽ nhận lỗi One or several params provided have wrong value, cũng như một count âm hoặc không phải số nguyên.