Skip to content

Client announcement & version control

Other Settings has two JSON fields for talking to your dedicated client apps (such as Siu) directly, outside of WHMCS:

  • Client Announcement
  • Version Control

Both are served publicly (no login required) through v2raysocks_client.php, using the X-User-Act request header:

X-User-Act valueReturns
getclientannouncementThe Client Announcement JSON
getversioncontrolThe Version Control JSON

Leave either field empty to disable it.

Client Announcement

Shown to the user when the client app starts. Suggested shape:

json
{
  "id": "announcement-20260517-001",
  "message": {
    "chinese": "客户端维护通知:我们将在今晚 23:00 进行短暂维护。",
    "english": "Client maintenance notice: we'll perform brief maintenance tonight at 23:00.",
    "russian": "Уведомление о техническом обслуживании клиента: сегодня в 23:00 мы проведем краткое обслуживание."
  },
  "notify_times": 1
}
  • id — unique identifier for this announcement. Change it whenever the content changes, so clients that already dismissed the previous announcement show the new one.
  • message — the announcement text, keyed by language.
  • notify_times — how many times the client should show it to a given user.

Version Control

Lets a client app check whether it's outdated or blocked from running. Suggested shape:

json
{
  "min_version": "1.0.0",
  "latest_version": "1.2.0",
  "download_url": "https://example.com/downloads"
}
  • min_version — the oldest client version still allowed to run.
  • latest_version — the current version, for "update available" prompts.
  • download_url — where the client should send users to update.

These two fields aren't validated against a fixed schema server-side — they're passed straight through as-is, so the exact shape only needs to match what your client app parses. The examples above are the shape this feature was introduced for; check your client's own documentation before relying on them.