Bant Genişliği Kuralını Güncelle

PATCH

api

bandwidth

auto-refill

{rule_id}

Bant Genişliği Kuralını Güncelle

curl --request PATCH \
  --url https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "threshold_bandwidth": 123,
  "add_volume": 123,
  "duration": "<string>",
  "label": "<string>",
  "status": "<string>"
}
'

import requests

url = "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

payload = {
    "threshold_bandwidth": 123,
    "add_volume": 123,
    "duration": "<string>",
    "label": "<string>",
    "status": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    threshold_bandwidth: 123,
    add_volume: 123,
    duration: '<string>',
    label: '<string>',
    status: '<string>'
  })
};

fetch('https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'threshold_bandwidth' => 123,
    'add_volume' => 123,
    'duration' => '<string>',
    'label' => '<string>',
    'status' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

	payload := strings.NewReader("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Bant Genişliği Kuralını Güncelle

Bir kuralın eşiğini, miktarını, süresini veya etiketini değiştirir ya da kuralı duraklatır ve devam ettirir. Yalnızca değiştirmek istediğiniz alanları gönderin; diğerleri olduğu gibi kalır. Değişiklikler bir sonraki kontrolden itibaren geçerli olur. buy_bandwidth kapsamını gerektirir. Bir kuralın adresi değiştirilemez. Bir kuralı başka bir adrese taşımak için onu silin ve yeni bir kural oluşturun.

Yol parametreleri

number

gerekli

Kural kimliği — Bant Genişliği Kuralı Oluştur veya Bant Genişliği Kurallarını Listele yanıtındaki id

İstek gövdesi

number

Yeni eşik. 1 ile 1.000.000 arasında.

number

Dolum başına yeni bant genişliği miktarı. 350 ile 100.000 arasında.

string

Sonraki dolumlar için yeni kiralama süresi: "1h" veya "1d". Zaten satın alınmış kiralamalar kendi sürelerini korur.

string

Yeni etiket, en fazla 100 karakter. Boş bir dize etiketi kaldırır.

string

Kuralı duraklatmak için "paused", devam ettirmek için "active". Devam ettirmek ayrıca stopped_reason alanını temizler ve consecutive_failures değerini 0’a sıfırlar. Bakiye nedeniyle durdurulmuş bir kural para yatırıldıktan sonra kendiliğinden devam eder, bu yüzden bunu sizin yapmanız gerekmez; bakiye hâlâ yetersizken devam ettirirseniz kural bir sonraki kontrolde yeniden durur. stopped_insufficient_balance doğrudan ayarlanamaz.

Yanıt

Güncellenmiş kural; alanları Bant Genişliği Kurallarını Listele ile aynıdır.

Örnek

curl -X PATCH https://api.tronrental.com/v1/bandwidth/auto-refill/15 \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"duration": "1d"}'

import requests

resp = requests.patch(
    "https://api.tronrental.com/v1/bandwidth/auto-refill/15",
    headers={"X-API-Key": "your_api_key"},
    json={"duration": "1d"},
)
print(resp.json())

const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto-refill/15", {
  method: "PATCH",
  headers: { "X-API-Key": "your_api_key", "Content-Type": "application/json" },
  body: JSON.stringify({ duration: "1d" }),
});
console.log(await resp.json());

Response

{
  "id": 15,
  "target_address": "TYourRecipientAddress1234567890abc",
  "label": "Payouts",
  "threshold_bandwidth": 1000,
  "add_volume": 5000,
  "duration": "1d",
  "status": "active",
  "stopped_reason": null,
  "consecutive_failures": 0,
  "last_checked_at": "2026-10-14T09:41:02Z",
  "last_available_bandwidth": 3655,
  "last_read_error_at": null,
  "last_refill_at": "2026-10-14T09:12:30Z",
  "refill_count": 4,
  "total_spent_trx": "1.480000",
  "created_at": "2026-10-14T08:15:00Z",
  "estimated_cost_per_refill_trx": "0.500000",
  "volume_below_threshold": false
}

Hatalar

Durum	Kod	Ne zaman
`403`	`FORBIDDEN`	API anahtarında `buy_bandwidth` kapsamı yok
`404`	`NOT_FOUND`	Hesabınızda bu kimliğe sahip bir bant genişliği kuralı yok (veya kural silinmiş)
`409`	`AUTOREFILL_IN_PROGRESS`	Bu kural için şu anda bir dolum satın alınıyor — bir dakika sonra yeniden deneyin
`422`	—	Bir değer aralık dışında, `duration` değeri `"1h"` veya `"1d"` değil ya da `status` değeri `"active"` veya `"paused"` değil

{
  "detail": {
    "error": {
      "code": "AUTOREFILL_IN_PROGRESS",
      "message": "A refill is in progress for this rule; try again in a minute"
    }
  }
}

Bant Genişliği Kuralını Güncelle

curl --request PATCH \
  --url https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "threshold_bandwidth": 123,
  "add_volume": 123,
  "duration": "<string>",
  "label": "<string>",
  "status": "<string>"
}
'

import requests

url = "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

payload = {
    "threshold_bandwidth": 123,
    "add_volume": 123,
    "duration": "<string>",
    "label": "<string>",
    "status": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    threshold_bandwidth: 123,
    add_volume: 123,
    duration: '<string>',
    label: '<string>',
    status: '<string>'
  })
};

fetch('https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'threshold_bandwidth' => 123,
    'add_volume' => 123,
    'duration' => '<string>',
    'label' => '<string>',
    'status' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}"

	payload := strings.NewReader("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/bandwidth/auto-refill/{rule_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"threshold_bandwidth\": 123,\n  \"add_volume\": 123,\n  \"duration\": \"<string>\",\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Temel API

Bant Genişliği Kiralamaları

Otomatik Dolum

Siparişler

Faturalar

Smart Mode

Transfer Paketleri

Hesap

Webhooks

Bant Genişliği Kuralını Güncelle

Bant Genişliği Kuralını Güncelle

Yol parametreleri

İstek gövdesi

Yanıt

Örnek

Hatalar

​Bant Genişliği Kuralını Güncelle

​Yol parametreleri

​İstek gövdesi

​Yanıt

​Örnek

​Hatalar

Bant Genişliği Kuralını Güncelle

Yol parametreleri

İstek gövdesi

Yanıt

Örnek

Hatalar