API documentation

Overview

Every subscription sold by the platform can also be sold through an API. Both APIs operate on the same orders, balances and servers as the dashboard: an order created by API appears in the customer panel, and a renewal done there is visible to the API.

Units and money

• All amounts are US dollars. The display currencies on the website never change what an order costs.
• traffic is gigabytes, users is the number of simultaneous connections.
• period is the subscription length in days (30, 60, 90, 120, 240).
• An order has one limit type: traffic or connections, never both.

Available regions

Authentication

Every request carries the API token of an active customer or reseller account as a bearer token. The token is shown in the customer panel (Account → API token) and can be rotated there at any time; rotation invalidates the old token immediately.

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json

The token identifies the account, so an order lookup is already scoped: an API client can only ever see and change its own orders.

Errors

The Standard API answers with a consistent envelope. Check success first, then error when it is false.

{
  "success": false,
  "error": "order_not_found",
  "message": "Order not found or does not belong to you"
}

The PerfectPanels API answers in its own shape: { "error": "..." } with HTTP 400 for a bad request and the documented object on success.

Limits & rate limits

Standard API /api/v1

All paths below are relative to https://royalnet.work/api/v1.

Create an order

curl -X POST https://royalnet.work/api/v1/order/create \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json" \
  -d "region=eu" -d "traffic=30" -d "period=90"

{
  "success": true,
  "message": "Order created successfully",
  "data": {
    "id": 1042,
    "region": "eu",
    "traffic": 30,
    "users": 0,
    "period": 90,
    "expire": "2026-01-23T10:00:00.000000Z",
    "cost": 12.5,
    "balance": 87.5,
    "subscription": "https://sub.example.com/abc123"
  }
}

Request a trial

Read an order

Renew

Renewal is only allowed once the subscription is finishing:

• traffic-based order: remaining traffic ≤ 20% of the limit;
• connection-based order: remaining days ≤ 10% of the period.

Increase / decrease a limit

Activate, deactivate, regenerate

All three take only id.

Update order metadata

Cancel

The unused share of the subscription is credited back to the balance. Trials and finished orders cannot be cancelled.

Account

Metadata

Use /meta/regions to discover what can be ordered right now instead of hard-coding region codes.

Network check

PerfectPanels API /api/perfect

How it works

This is a single endpoint that speaks the PerfectPanel protocol: one POST to https://royalnet.work/api/perfect with an action field. It exists so a PerfectPanel installation can resell these subscriptions as a provider without any custom code.

• Authentication is the same bearer token.
• Services are generated from the live price list, so the panel always sees current availability and rates.
• Rates are returned in the panel's convention: USD × 1000.

action=services

Lists everything that can be sold. Categories follow [REGION] Traffic Based (30D) and [REGION] User Based (30D).

curl -X POST https://royalnet.work/api/perfect \
  -H "Authorization: Bearer $TOKEN" \
  -d "action=services"

[
  {
    "service": 1,
    "name": "10GB - Unlimited User - 30 Days",
    "type": "Default",
    "category": "[EU] Traffic Based (30D)",
    "rate": "1250.000",
    "min": 1,
    "max": 10,
    "refill": false,
    "cancel": false
  }
]

action=add

Creates an order and charges the balance.

{ "order": 1042 }

action=status

Accepts one or more order ids (orders, comma separated).

{
  "charge": "1250.000",
  "start_count": null,
  "status": "active",
  "remains": 30,
  "currency": "USD"
}

remains is remaining gigabytes for a traffic order and remaining days for a connection order. Status values mirror the panel: active, inactive, finished, blocked.

action=balance

{ "balance": "87.5000", "current": "USD" }

Connect a PerfectPanel

1. In PerfectPanel: Providers → Add provider → API.
2. URL: https://royalnet.work/api/perfect
3. Key: the customer's API token from the RoyalNetwork panel.
4. Save, then press Sync services. The generated catalogue appears as categories grouped by region and period.

Need help?

Open a ticket from the dashboard (Support) or contact us. Include the order id and the timestamp of the failing call - both are logged.

立即开始