Renew Static Proxy

What this endpoint does

Use this endpoint to renew one or more static proxy. A renewal deducts funds from your account balance, so confirm the node IDs, renewal period, and available balance before submitting the request.

Endpoint

POST /openapi/static/node/renew

Full URL:

https://{domain}/openapi/static/node/renew

Include your user-id and access-key in the request headers.

Body parameters

Example parameter values for one proxy:

{
  "renew_days": 30,
  "node_id": "xK9mP2nQ"
}

Example parameter values for multiple proxies:

{
  "renew_days": 30,
  "node_id": "xK9mP2nQ,yL0nR3sT"
}

Note: The current API specification does not define the request body’s Content-Type. Before implementing this endpoint, confirm the format required for your QuarkIP environment and submit the parameters as JSON, form data, or another supported format accordingly.

Response fields

Example response

{
  "code": 0,
  "msg": "Ok",
  "info": {
    "trade_no": "gH7iJ9kL",
    "renew_days": 30,
    "node_qty": 3
  }
}

After a successful request, save the returned trade_no. You can use the Get Static Proxy Transaction Details endpoint to verify the amount, node quantity, and transaction type.

Before submitting a renewal

• Make sure every node_id belongs to your account.
• Confirm that each node is eligible for renewal.
• Make sure renew_days is supported by the product’s renewal rules.
• Confirm that your account has enough balance to cover the renewal.
• If you automate renewals, handle uncertain responses carefully to avoid submitting the same renewal more than once.

Common renewal errors

• 400: A required parameter, such as renew_days or node_id, is missing.
• 402: Your account balance is insufficient.
• 403: One or more proxy do not support renewal.
• 422: The renewal period or another business rule failed validation.

If the proxy parameter is missing, the error message may say missing params node_ids. The request parameter is still named node_id.