API กระเป๋าเงิน
Wallet API สร้างกระเป๋าเงิน และดึงข้อมูลกระเป๋าเงินและยอดเงินของมัน
สร้างกระเป๋า
สร้างคู่กุญแจสาธารณะ - กุญแจส่วนตัว (หรือวลีช่วยจำ) และที่อยู่กระเป๋าเงิน
URL การร้องขอ
พารามิเตอร์หัวเรื่อง
ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น |
x-network | เครือข่ายบล็อกเชน | สตริง | ใช่ |
Authorization | โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API | สตริง | ใช่ |
การตอบสนอง
ชื่อฟิลด์ | คำอธิบาย | ประเภท |
code | รหัสผลลัพธ์คำขอ API, 0: สำเร็จ | หมายเลข |
message | ข้อความผลลัพธ์ | สตริง |
data | ข้อมูลการตอบกลับ API | json |
data.address | ที่อยู่กระเป๋าเงินที่สร้างขึ้น | สตริง |
data.privateKey | กุญแจส่วนตัวของกระเป๋าเงินที่สร้างขึ้น | สตริง |
data.publicKey | กุญแจสาธารณะของกุญแจที่สร้างขึ้น (xpla) | สตริง |
ตัวอย่างคำขอ
curl -X 'POST'
'https://sandbox-bc-api.qpyou.cn/core/v0/wallet'
-H 'accept: */*'
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'
-H 'x-network: polygon'
-d ''
ตัวอย่างการตอบกลับ
// Polygon
{
"code": 0,
"message": "success",
"data": {
"address": "0x413a1bF6584fF29d663f6CE5cf3F1Fce2064cf4d",
"privateKey": "0x250748507c8d83cc71fb4178d0b989062dc8e02ea050f9078ae0d8fbfda4d845"
}
}
// Xpla
{
"code": 0,
"message": "success",
"data": {
"address": "xpla1xckvhyu48uqlhduqgd79y45tpfhqlnrqhr87nt",
"publicKey": "AvNhefa+7fhS7RH/VryEtz1yWzXKGS1+jnheotpOMuSV",
"privateKey": "pledge outdoor ginger assault key luxury appear roast immense march burden charge season sea raw suspect tenant fossil portion easily onion fragile castle spoil"
}
}
รับข้อมูลกระเป๋าเงิน
รับข้อมูลเกี่ยวกับสถานะบัญชี เช่น nonce (ลำดับ), หมายเลขบัญชี และอื่นๆ รับสถานะบัญชีรวมถึง nonce (ลำดับ) และหมายเลขบัญชี หากกระเป๋าเงินเป็น กระเป๋าเงินหลายลายเซ็น API จะส่งคืน เกณฑ์ ที่จำเป็นสำหรับการส่งธุรกรรมจากกระเป๋าเงินนี้และข้อมูลเกี่ยวกับผู้ลงนาม
URL การร้องขอ
พารามิเตอร์เส้นทาง
ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น |
address | ที่อยู่ของบัญชีที่ข้อมูลจะถูกส่งกลับ | string | Y |
พารามิเตอร์หัวเรื่อง
ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น |
x-network | เครือข่ายบล็อกเชน | สตริง | ใช่ |
Authorization | โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API | สตริง | ใช่ |
การตอบกลับ
ชื่อฟิลด์ | คำอธิบาย | ประเภท |
code | รหัสผลลัพธ์ของคำขอ API, 0: สำเร็จ | number |
message | ข้อความผลลัพธ์ | String |
data | ข้อมูลการตอบกลับของ API | json |
data.nonce | nonce (ลำดับ) ของกระเป๋าเงิน | number |
data.accountNumber | หมายเลขบัญชีของกระเป๋าเงิน (xpla) | number |
data.publicKey | คีย์สาธารณะของกระเป๋าเงิน (xpla) | string |
data.type | ประเภทของกระเป๋าเงิน * SINGLE: กระเป๋าเงินแบบลายเซ็นเดียว * MULTI: กระเป๋าเงินแบบลายเซ็นหลายตัว | string |
data.signers | หากประเภทกระเป๋าเงินคือ MULTI , ที่อยู่กระเป๋าเงินของผู้ลงนามหลายคน | array |
data.threshold | เกณฑ์สำหรับลายเซ็นหลายตัว | number |
ตัวอย่างคำขอ
curl -X 'GET'
'https://sandbox-bc-api.qpyou.cn/core/v1/wallet/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765'
-H 'accept: */*'
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'
-H 'x-network: polygon'
ตัวอย่างการตอบกลับ
// Polygon (SINGLE)
{
"code": 0,
"message": "success",
"data": {
"nonce": 185,
"type": "SINGLE"
}
}
// Xpla (SINGLE)
{
"code": 0,
"message": "success",
"data": {
"nonce": 52,
"accountNumber": 4658,
"publicKey": "xplapub1qtet7gjzyt6h3rm79ragfanses4xwgx6hjtjzh2juvtklxhup5gpgepz4yz",
"type": "SINGLE"
}
}
// Polygon (MULTI)
{
"code": 0,
"message": "success",
"data": {
"nonce": 185,
"type": "MULTI",
"signers": ["xpla1c49ehdl8dcd3wv0vj52h25gfxkxkr7sfpvqrhw", "xpla1gzq6a8t4dt9lpth6ufzlnnvll9cdsdfgmrhk73", "xpla16xhh685u829vrm407sq8rf82wt4gjudslzgtm7 "],
"threshold": 2
}
}
// Xpla (MULTI)
{
"code": 0,
"message": "success",
"data": {
"nonce": 52,
"accountNumber": 4658,
"publicKey": "xplapub1qtet7gjzyt6h3rm79ragfanses4xwgx6hjtjzh2juvtklxhup5gpgepz4yz",
"type": "MULTI",
"signers": ["0xD6e69da7f1be111394dfef4C48eaC9b52ddf2Fd0", "0xA10078576Ca6f63dc6f78ff9a8ed8bd05B51f463", "0xa245824a24daf3b312d3f59c7debf162c4993e8b"],
"threshold": 2
}
}
รับยอดเงินในกระเป๋า
รับยอดคงเหลือ (Polygon: matic, XPLA: xpla) ของกระเป๋าเงิน
URL ที่ร้องขอ
พารามิเตอร์เส้นทาง
ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น |
address | ที่อยู่ของบัญชีที่ข้อมูลจะถูกส่งกลับ | string | Y |
พารามิเตอร์หัว
ชื่อฟิลด์ | คำอธิบาย | ประเภท | จำเป็น |
x-network | เครือข่ายบล็อกเชน | สตริง | ใช่ |
Authorization | โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API | สตริง | ใช่ |
การตอบกลับ
ชื่อฟิลด์ | คำอธิบาย | ประเภท |
code | รหัสผลลัพธ์การร้องขอ API, 0: สำเร็จ | หมายเลข |
message | ข้อความผลลัพธ์ | สตริง |
data | ข้อมูลการตอบกลับ API | json |
data.balance | ยอดเงินที่บัญชีมี | สตริง |
data.rawBalance | ยอดเงินในกระเป๋าของบัญชีที่ไม่ใช้ data.decimals | สตริง |
data.decimals | จำนวนตำแหน่งทศนิยมสูงสุดของโทเค็น | หมายเลข |
ตัวอย่างคำขอ
curl -X 'GET'
'https://sandbox-bc-api.qpyou.cn/core/v1/wallet/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765/balance'
-H 'accept: */*'
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'
-H 'x-network: polygon'
ตัวอย่างการตอบกลับ
{
"code": 0,
"message": "success",
"data": {
"balance": "0.198284931197886585",
"rawBalance": "198284931197886585",
"decimals": 18
}
}