ایستگاه کارمزد

GET/v1/fee-station

ایستگاه کارمزد سازمان روی یک شبکه. سازمان بی ایستگاه فقط found برابر false می‌گیرد.

دسترسی لازم

read

سقف نرخ در دقیقه

120 برای هر کلید

درخواست

curl

curl 'https://api.romu.ir/v1/fee-station?network=TRON' \
  -H "X-Custody-Key-Id: $KEY_ID" \
  -H "X-Custody-Timestamp: $TIMESTAMP" \
  -H "X-Custody-Nonce: $NONCE" \
  -H "X-Custody-Signature: $SIGNATURE"

TypeScript

import { romu } from "./romu.ts";

const res = await romu.get("/v1/fee-station", {
  query: "network=TRON",
});
console.log(res.status, res.body);

Go

status, body, err := client.Get("/v1/fee-station", "network=TRON")

Python

import romu

status, body = romu.get(
    "/v1/fee-station",
    query="network=TRON",
)
print(status, body)

امضای درخواست را کتابخانه انجام می‌دهد؛ جزئیات: صفحه‌ی امضا

پارامترهای query

networkstring

پیش‌فرض TRON⁠.TRONBSC

پاسخ

200ایستگاه کارمزد.

نمونه

{
  "found": true,
  "wallet_id": "01926e00-0000-7000-8000-000000000301",
  "network": "TRON",
  "address": "TDHakFLTixSuJF5xxDsmvZ9zSn2TvQM9YL",
  "balance": "150.5",
  "asset": "TRON_TRX",
  "enabled": true,
  "per_tx_cap": "30",
  "daily_cap": "1000",
  "topped_up_24h": "60",
  "threshold": "200",
  "below": true
}

فیلدها

foundbooleanلازم

بی ایستگاه false است و فیلد دیگری نمی‌آید.

wallet_idstring

networkstring

TRONBSC

addressstring

آدرس شارژ ایستگاه.

balancestring

موجودی همین آدرس روی زنجیره.

assetstring

enabledboolean

per_tx_capstring

سقف هر شارژ.

daily_capstring

سقف 24 ساعت غلتان.

topped_up_24hstring

جمع شارژهای 24 ساعت گذشته.

thresholdstring

آستانه‌ی هشدار.

belowboolean

موجودی زیر آستانه است.

خطاها

400invalid request یا malformed request body⁠: بدنه، پارامتر یا فیلد نادرست است، یا فیلد ناشناخته دارد.

401unauthenticated⁠: هر شکست احراز هویت همین پاسخ را دارد.

403permission denied⁠: کلید دسترسی این مسیر را ندارد.

429too many requests⁠: بیش از سقف نرخ. پس از Retry-After ثانیه دوباره بفرستید.

503try again later⁠: سرویس موقتاً در دسترس نیست.

بدنه‌ی خطا همیشه {"error":"..."} است. راهنمای خطاها می‌گوید برای هر کد چه باید کرد.