برداشت TON
POST
/api/v1/wallet/ton/withdrawalsscope: wallet:writeاحراز هویت: Bearerlive و test
برداشت TON فقط به کیف پولی که مالک حساب با TON Connect در مینیاپ وصل کرده (آدرس دلخواه پذیرفته نمیشود تا کلید لورفته نتواند پول را جای دیگری بفرستد). برداشتهای غیرعادی به صف بررسی میروند.
درخواست
| نام | محل | نوع | توضیح | |
|---|---|---|---|---|
Authorization | header | string | الزامی | Bearer sk_live_… یا Bearer sk_test_… |
بدنه (JSON)
| فیلد | نوع | توضیح | |
|---|---|---|---|
source | string | الزامی | ton یا toman |
amount | string | الزامی | مبلغ |
نمونه
curl -X POST "https://stard-market.ir/api/v1/wallet/ton/withdrawals" \
-H "Authorization: Bearer $STARD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"source": "ton", "amount": "2.5"}'const res = await fetch("https://stard-market.ir/api/v1/wallet/ton/withdrawals", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.STARD_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"source": "ton",
"amount": "2.5"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
console.log(data);type StardError = { error: { type: string; code: string; message: string; param: string | null; request_id: string } };
const res = await fetch("https://stard-market.ir/api/v1/wallet/ton/withdrawals", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.STARD_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"source": "ton",
"amount": "2.5"
}),
});
if (!res.ok) {
const { error } = (await res.json()) as StardError;
throw new Error(`${error.code}: ${error.message} (${error.request_id})`);
}
const data: Record<string, unknown> = await res.json();import os
import requests
r = requests.post(
"https://stard-market.ir/api/v1/wallet/ton/withdrawals",
headers={
"Authorization": f"Bearer {os.environ['STARD_API_KEY']}",
},
json={
"source": "ton",
"amount": "2.5"
},
timeout=20,
)
data = r.json()
if r.status_code >= 400:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")
print(data)<?php
$ch = curl_init("https://stard-market.ir/api/v1/wallet/ton/withdrawals");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("STARD_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"source" => "ton",
"amount" => "2.5"
]),
CURLOPT_TIMEOUT => 20,
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) {
throw new RuntimeException($data["error"]["code"] . ": " . $data["error"]["message"]);
}
print_r($data);package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{"source": "ton", "amount": "2.5"}`)
req, _ := http.NewRequest("POST", "https://stard-market.ir/api/v1/wallet/ton/withdrawals", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("STARD_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
b, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(b))
}خطاها
| HTTP | code | کی |
|---|---|---|
400 | ton_wallet_not_linked | کیف پول TON وصل نیست |
400 | live_only | فقط با کلید live |
403 | insufficient_scope | کلید scope wallet:write را ندارد |
401 | invalid_api_key / missing_api_key / api_key_revoked / api_key_expired | کلید نیامده، نامعتبر، باطل یا منقضی است |
429 | rate_limit_exceeded | سقف درخواست در دقیقه پر شده؛ بعد از Retry-After ثانیه دوباره بفرست |
محدودیت نرخ
پیشفرض ۶۰ درخواست در دقیقه برای هر کلید (قابل تنظیم در داشبورد). وضعیت در هدرهای X-RateLimit-* برمیگردد — جزئیات.
