Bắt đầu nhanh
Hoàn thành cuộc gọi API đầu tiên của bạn trong 10 phút
1. Tạo API Key
Tạo API Key đầu tiên của bạn trong Console
- Đi tới Cài đặt tài khoản → API Keys
- Nhấp vào nút "Tạo API Key"
- Nhập tên khóa (ví dụ: Production)
- Sao chép và lưu API Key được tạo (chỉ hiển thị một lần)
⚠️ API Keys chỉ hiển thị một lần khi tạo. Vui lòng lưu trữ an toàn.
2. Gửi yêu cầu đầu tiên
Kiểm tra kết nối API bằng curl
Lấy số dư ví
BASE_URL=... # Domain thực tế của môi trường production
API_KEY=ak_live_...
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/wallet/balance"Ví dụ phản hồi
{
"data": {
"balanceSun": 1000000,
"frozenSun": 0,
"totalSun": 1000000
}
}
// Để biết giải thích về đơn vị và kiểu dữ liệu, xem <a href="/vi/docs/endpoints" class="text-blue-600 hover:underline">Điểm cuối API</a>3. Tạo đơn hàng năng lượng
Thuê năng lượng cho một địa chỉ được chỉ định
Tạo đơn hàng
curl -X POST "$BASE_URL/v1/energy/orders" \
-H "Authorization: ApiKey $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "manual",
"data": {
"tronAddress": "TYour1Address2Here3...",
"energyValue": 65000,
"durationHours": 1
}
}'
// tronAddress: 34 ký tự, bắt đầu bằng T
// durationHours: 1, 24, 72, 168, 336, 720 (giờ)Ví dụ phản hồi
{
"data": {
"id": 1234567890,
"status": "processing",
"priceSun": 3000000,
"createdAt": "2025-01-15T10:30:00Z"
}
}4. Kiểm tra trạng thái đơn hàng
Xác minh xem đơn hàng đã hoàn thành chưa
Truy vấn đơn hàng
curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/energy/orders/1234567890"Ví dụ phản hồi
{
"data": {
"id": 1234567890,
"status": "completed",
"txid": "abc123...",
"completedAt": "2025-01-15T10:30:05Z"
}
}