Actualizar regla de energía

PATCH

api

energy

auto-refill

{rule_id}

Actualizar regla de energía

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

Actualizar regla de energía

Cambia el umbral, el volumen o la etiqueta de una regla, o la pausa y la reanuda. Envía solo los campos que quieras cambiar; los demás se quedan como están. Los cambios se aplican desde la siguiente comprobación. Requiere el alcance buy_energy. La dirección y la duración de una regla no se pueden cambiar. Para pasar una regla a otra dirección, elimínala y crea una nueva.

Parámetros de ruta

number

requerido

ID de la regla — el id que devuelven Crear o Listar reglas de energía

Cuerpo de la solicitud

number

Nuevo umbral. De 1 a 50,000,000.

number

Nueva cantidad de energía por recarga. De 32,000 a 5,000,000.

string

Nueva etiqueta, hasta 100 caracteres. Una cadena vacía elimina la etiqueta.

string

"paused" para pausar la regla, "active" para reanudarla. Al reanudarla también se borra stopped_reason y consecutive_failures vuelve a 0. Una regla detenida por saldo se reanuda sola tras un depósito, así que no tienes que hacerlo tú; si la reanudas mientras el saldo sigue sin alcanzar, se detiene de nuevo en la siguiente comprobación. stopped_insufficient_balance no se puede establecer directamente.

Respuesta

La regla actualizada, con los mismos campos que en Listar reglas de energía.

Ejemplo

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
}

Errores

Estado	Código	Cuándo
`403`	`FORBIDDEN`	La clave API carece del alcance `buy_energy`
`404`	`NOT_FOUND`	No hay ninguna regla de energía con este ID en tu cuenta (o fue eliminada)
`409`	`AUTOREFILL_IN_PROGRESS`	Se está comprando una recarga para esta regla en este momento — reintenta en un minuto
`422`	—	Un valor está fuera de rango, o `status` no es `"active"` ni `"paused"`

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

Actualizar regla de energía

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

Alquileres de ancho de banda

Recarga automática

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Actualizar regla de energía

Actualizar regla de energía

Parámetros de ruta

Cuerpo de la solicitud

Respuesta

Ejemplo

Errores

​Actualizar regla de energía

​Parámetros de ruta

​Cuerpo de la solicitud

​Respuesta

​Ejemplo

​Errores

Actualizar regla de energía

Parámetros de ruta

Cuerpo de la solicitud

Respuesta

Ejemplo

Errores