Enerji Kuralını Güncelle

PATCH

api

energy

auto-refill

{rule_id}

Enerji Kuralını Güncelle

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

import requests

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

payload = {
    "threshold_energy": 123,
    "add_volume": 123,
    "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_energy: 123, add_volume: 123, label: '<string>', status: '<string>'})
};

fetch('https://api.example.com/api/v1/energy/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/energy/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_energy' => 123,
    'add_volume' => 123,
    '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/energy/auto-refill/{rule_id}"

	payload := strings.NewReader("{\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\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/energy/auto-refill/{rule_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/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_energy\": 123,\n  \"add_volume\": 123,\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}"

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

Enerji Kuralını Güncelle

Bir kuralın eşiğini, miktarını 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_energy kapsamını gerektirir. Bir kuralın adresi ve süresi 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 — Enerji Kuralı Oluştur veya Enerji Kurallarını Listele yanıtındaki id

İstek gövdesi

number

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

number

Dolum başına yeni enerji miktarı. 32.000 ile 5.000.000 arasında.

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ı Enerji Kurallarını Listele ile aynıdır.

Örnek

curl -X PATCH https://api.tronrental.com/v1/energy/auto-refill/12 \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"status": "paused"}'

import requests

resp = requests.patch(
    "https://api.tronrental.com/v1/energy/auto-refill/12",
    headers={"X-API-Key": "your_api_key"},
    json={"status": "paused"},
)
print(resp.json())

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

Response

{
  "id": 12,
  "target_address": "TYourRecipientAddress1234567890abc",
  "label": "Hot wallet",
  "threshold_energy": 65000,
  "add_volume": 131000,
  "duration": "1h",
  "status": "paused",
  "stopped_reason": null,
  "consecutive_failures": 0,
  "last_checked_at": "2026-10-14T09:41:02Z",
  "last_available_energy": 212480,
  "last_read_error_at": null,
  "last_refill_at": "2026-10-14T08:57:40Z",
  "refill_count": 3,
  "total_spent_trx": "7.854000",
  "created_at": "2026-10-14T08:12:05Z",
  "estimated_cost_per_refill_trx": "2.618000",
  "volume_below_threshold": false
}

Hatalar

Durum	Kod	Ne zaman
`403`	`FORBIDDEN`	API anahtarında `buy_energy` kapsamı yok
`404`	`NOT_FOUND`	Hesabınızda bu kimliğe sahip bir enerji 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 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"
    }
  }
}

Enerji Kuralını Güncelle

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

import requests

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

payload = {
    "threshold_energy": 123,
    "add_volume": 123,
    "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_energy: 123, add_volume: 123, label: '<string>', status: '<string>'})
};

fetch('https://api.example.com/api/v1/energy/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/energy/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_energy' => 123,
    'add_volume' => 123,
    '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/energy/auto-refill/{rule_id}"

	payload := strings.NewReader("{\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\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/energy/auto-refill/{rule_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"threshold_energy\": 123,\n  \"add_volume\": 123,\n  \"label\": \"<string>\",\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/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_energy\": 123,\n  \"add_volume\": 123,\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

Enerji Kuralını Güncelle

Enerji Kuralını Güncelle

Yol parametreleri

İstek gövdesi

Yanıt

Örnek

Hatalar

​Enerji Kuralını Güncelle

​Yol parametreleri

​İstek gövdesi

​Yanıt

​Örnek

​Hatalar

Enerji Kuralını Güncelle

Yol parametreleri

İstek gövdesi

Yanıt

Örnek

Hatalar