Chuyển tới nội dung chính

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ểuBắt buộcMô tả
domain_namestringCó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ểuMặc địnhMô tả
countinteger100Số dòng tối đa trả về, tới 500: số lớn hơn bị cắt xuống 500.
from_block_idintegerKhô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_nonceintegerKhô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.
orderstringdescThứ 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 -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"
}'

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ườngKiểuMô tả
domain_block_idintKhối PIVX chứa thao tác
domain_tsintThời gian của khối đó, tính bằng giây Unix
target_addressstringĐịa chỉ mà tên phân giải tới sau thao tác
opstringThao tác: REG, UPD, CHG, LST, ULT hoặc BUY
owner_pubkeystringKhóa công khai của chủ sở hữu tên sau thao tác
domain_txstringBăm của giao dịch PIVX mang thao tác này
nonceintNonce của thao tác: một dấu thời gian tăng theo mỗi thao tác trên tên
priceintGiá 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.