Static proxy
Static proxy
Create a Static Proxy Renewal Order
POST /open-api/v1/static/renewal-orders endpoint reference.
Create a Static Proxy Renewal Order
POST /open-api/v1/static/renewal-orders
Base URL: https://api.ipbunker.online/gin.
Authentication
Send your key in the X-API-Key request header.
JSON request body
| Field | Type | Required | Constraints | Meaning |
|---|---|---|---|---|
request_no |
string |
Yes | minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$ | Caller request number for duplicate protection. |
resource_ids |
string[] |
Yes | minItems: 1; maxItems: 500 | Resource IDs selected for renewal. |
duration_days |
integer |
Yes | format: int32; minimum: 1 | Duration in days. Use a positive integer supported by the active price catalog. |
callback_url |
string |
No | maxLength: 2048 | Optional terminal status callback URL, subject to server validation. |
Request example
curl --request POST \
--url 'https://api.ipbunker.online/gin/open-api/v1/static/renewal-orders' \
--header 'Accept: application/json' \
--header 'X-API-Key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"request_no": "static_renew_20260824_001",
"resource_ids": [
"1912345678901234567"
],
"duration_days": 30
}'
Success response data
Responses use code, msg, data, and next. HTTP 200 can also contain a nonzero business error code; check code first.
| Field | Type | Required | Constraints | Meaning |
|---|---|---|---|---|
data.order_no |
string |
No | — | Order no. |
data.status |
string |
No | enum: PROCESSING | Current status of this resource or order. |
data.duration_days |
integer |
No | format: int32; minimum: 1 | Duration in days. Use a positive integer supported by the active price catalog. |
data.total_quantity |
integer |
No | format: int32; minimum: 1; maximum: 500 | Total quantity. |
data.order_amount |
string |
No | — | Order or quote amount as a decimal string. |
data.currency |
string |
No | — | Currency. |
data.create_time |
string |
No | format: date-time | Create time. |
Endpoint notes
The wallet is charged when the renewal order is accepted; fulfillment is asynchronous. All resources use the same positive integer duration. Each resource group must have an active price.
Related conventions
Request conventions · Response structure · Error codes · API reference index