Get AceDataCloud Platform Global Configuration

Returns the global public configuration of the AceDataCloud platform—such as default free quota, default currency, default CDN domain name, homepage carousel images, SEO meta information, customer service contact information, document versions, etc. It can be called once at the front end startup to obtain all necessary "environment constants."

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/.

¶ Interface Overview

Item	Content
Method	`GET`
URL	`https://platform.acedata.cloud/api/v1/config/`
Authentication	❌ Public
Cache	The server has a short cache of 60 seconds, safe for high-frequency calls

¶ Authentication Description

This interface is completely public, no account token or login state required.

¶ Query Parameters

Parameter	Type	Required	Default	Description
`lang`	string	No	—	Explicit language code; if not provided, it will negotiate automatically according to the `Accept-Language` header

¶ Request Example

¶ cURL

curl 'https://platform.acedata.cloud/api/v1/config/' \
  -H 'accept: application/json' \
  -H 'accept-language: zh-CN'

¶ Python

import requests

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/config/",
    headers={"accept": "application/json"},
    timeout=10,
)
cfg = resp.json()
print("Brand Name:", cfg.get("site_name"))
print("Default Currency:", cfg.get("default_currency"))
print("Customer Service Email:", cfg.get("contact_email"))

¶ Node.js

const r = await fetch('https://platform.acedata.cloud/api/v1/config/')
const cfg = await r.json()
console.log(cfg)

¶ Response Example (HTTP 200)

{
  "site_name": "AceDataCloud",
  "site_url": "https://platform.acedata.cloud",
  "cdn_url": "https://cdn.acedata.cloud",
  "default_currency": "CNY",
  "supported_currencies": ["CNY", "USD", "USDC", "SOL"],
  "supported_languages": ["zh-CN", "en-US", "ja", "ko", "fr", "de", "ar"],
  "contact_email": "support@acedata.cloud",
  "contact_phone": "+86-400-xxx-xxxx",
  "wechat_group_qr": "https://cdn.acedata.cloud/wechat-group.png",
  "telegram_group_url": "https://t.me/acedatacloud",
  "discord_url": "https://discord.gg/acedatacloud",
  "github_url": "https://github.com/AceDataCloud",
  "banner_url": null,
  "announcements": [
    {
      "id": "ann-001",
      "title": "GPT-4.1 is now online, experience it immediately",
      "url": "/services/openai",
      "level": "info",
      "expires_at": "2026-05-01T00:00:00Z"
    }
  ],
  "metadata": null
}

¶ Response Field Description

Field	Type	Description
`site_name`	string	Site name
`site_url`	string	Main domain URL
`cdn_url`	string	CDN main domain URL
`default_currency`	string	Default settlement currency
`supported_currencies`	array	All supported currency codes
`supported_languages`	array	List of supported language codes
`contact_email`	string	Customer service email
`contact_phone`	string	Customer service phone
`wechat_group_qr`	string	null
`telegram_group_url`	string	null
`discord_url`	string	null
`github_url`	string	null
`banner_url`	string	null
`announcements`	array	List of site announcements
`metadata`	object	null

⚠️ The actual returned fields may exceed those listed in this table—the platform will add fields for backward compatibility but will not remove existing fields. Please read as needed, do not assume a complete set of fields.

¶ Error Handling

This interface rarely encounters errors. Common non-200 situations:

HTTP	Meaning
502 / 503 / 504	Gateway or backend temporarily unavailable, retry 1-3 times

¶ Practical Tips

Pull cache once at front end startup: config will not change within 5 minutes, store it in SWR / React Query.
Do not hard-code cdn_url: The CDN may switch in the future; reading from this interface will automatically follow.
announcements are used for the top banner of the site: Contains the level field (info/warn/success), the front end renders styles according to the level.