Atualizar regra de energia

PATCH

api

energy

auto-refill

{rule_id}

Atualizar regra de energia

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

Atualizar regra de energia

Altera o limiar, o volume ou o rótulo de uma regra, ou a pausa e retoma. Envie apenas os campos que deseja alterar; os demais permanecem como estão. As alterações valem a partir da verificação seguinte. Exige o escopo buy_energy. O endereço e a duração de uma regra não podem ser alterados. Para mover uma regra para outro endereço, exclua-a e crie uma nova.

Parâmetros de caminho

number

obrigatório

ID da regra — o id retornado por Criar ou Listar regras de energia

Corpo da requisição

number

Novo limiar. De 1 a 50.000.000.

number

Nova quantidade de energia por recarga. De 32.000 a 5.000.000.

string

Novo rótulo, até 100 caracteres. Uma string vazia remove o rótulo.

string

"paused" para pausar a regra, "active" para retomá-la. Retomar também limpa stopped_reason e redefine consecutive_failures para 0. Uma regra parada por saldo é retomada sozinha após um depósito, então você não precisa fazer isso; se você a retomar enquanto o saldo ainda for insuficiente, ela para de novo na verificação seguinte. stopped_insufficient_balance não pode ser definido diretamente.

Resposta

A regra atualizada, com os mesmos campos de Listar regras de energia.

Exemplo

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
}

Erros

Status	Código	Quando
`403`	`FORBIDDEN`	A chave de API não tem o escopo `buy_energy`
`404`	`NOT_FOUND`	Não há regra de energia com este ID na sua conta (ou ela foi excluída)
`409`	`AUTOREFILL_IN_PROGRESS`	Uma recarga desta regra está sendo comprada neste momento — tente novamente em um minuto
`422`	—	Um valor está fora do intervalo, ou `status` não é `"active"` nem `"paused"`

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

Atualizar regra de energia

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

API Principal

Aluguéis de largura de banda

Recarga automática

Pedidos

Faturas

Smart Mode

Pacotes de transferência

Conta

Webhooks

Atualizar regra de energia

Atualizar regra de energia

Parâmetros de caminho

Corpo da requisição

Resposta

Exemplo

Erros

​Atualizar regra de energia

​Parâmetros de caminho

​Corpo da requisição

​Resposta

​Exemplo

​Erros

Atualizar regra de energia

Parâmetros de caminho

Corpo da requisição

Resposta

Exemplo

Erros