Appearance
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 value | Returns |
|---|---|
getclientannouncement | The Client Announcement JSON |
getversioncontrol | The 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.