Partner Feed v1 数据格式

在你的域名下发布一个 JSON 文件（建议 /.well-known/cloudmac.json），通过 HTTPS 公开访问即可。我们每天读取一次。完整的机器可读定义见 JSON Schema，写好后用在线校验检查。

规则

只写真实、当前有效的信息；不确定的选填字段直接省略。
offers[].id 一旦使用请保持不变，价格历史按 ID 记录。
价格按官网标价填写，币种、周期如实；必须额外支付的服务费用 surcharge_pct 写明。
价格大幅变动、新增机房等变化会经过人工审核后上线；数据与官网长期不一致时会取消直连标识。

字段

字段	要求	说明
`version`	必填	固定为 "1"
`updated_at`	必填	文件最后修改日期，YYYY-MM-DD
`provider.name / website`	必填	品牌名与官网
`provider.contact`	选填	email / telegram / wechat
`provider.support_languages`	选填	客服语言，如 ["zh","en"]
`provider.payment_methods`	选填	card / paypal / alipay / wechat / usdt / crypto / bank
`provider.trial`	选填	试用或退款政策，一句话
`provider.trial_en`	选填	英文试用或退款政策；provider.trial 不是英文时填写
`offers[]`	必填	当前在售的全部套餐；列表里消失的套餐视为下架
`offers[].id`	必填	套餐的稳定 ID，小写字母、数字、连字符，之后不要更改
`offers[].service_type`	必填	dedicated（独占实体机）/ vps（macOS 虚拟机）/ shared / colo（托管）/ ci
`offers[].hardware`	必填	family（mac-mini / mac-studio / mac-pro / vm）、chip、ram_gb、storage_gb；cpu_cores、gpu_cores 选填
`offers[].locations[]`	必填	country 用两位国家代码（JP、SG、US…），city 选填
`offers[].network`	选填	bandwidth_mbps、traffic_tb（null=不限）、ipv4、ip_type（residential / isp / datacenter）、ip_dedicated
`offers[].access`	选填	root、ssh、vnc、uu_remote、rustdesk、kvm、custom_software、reinstall，true / false
`offers[].prices[]`	必填	amount、currency（USD / EUR / CNY…）、period（hour / day / week / month / quarter / year）；vat_included、setup_fee、surcharge_pct（必付服务费 %）、min_term_months、note、note_en 选填
`offers[].stock`	必填	in_stock / sold_out / coming_soon / unknown
`offers[].url`	选填	该套餐的下单页
`deals[]`	选填	优惠活动：id、title、code、url、starts_at、expires_at
`affiliate`	选填	推广链接 url 与条款 terms

示例

下载示例文件

{
  "version": "1",
  "updated_at": "2026-10-19",
  "provider": {
    "name": "Example Mac Cloud",
    "website": "https://example.com/",
    "contact": { "email": "[email protected]", "telegram": "@example" },
    "support_languages": ["zh", "en"],
    "payment_methods": ["card", "alipay", "usdt"],
    "trial": "首月 7 天内无理由退款"
  },
  "offers": [
    {
      "id": "m4-16-256",
      "name": "Mac mini M4 基础版",
      "service_type": "dedicated",
      "hardware": { "family": "mac-mini", "chip": "M4", "cpu_cores": 10, "gpu_cores": 10, "ram_gb": 16, "storage_gb": 256 },
      "network": { "bandwidth_mbps": 1000, "traffic_tb": null, "ipv4": true, "ip_type": "datacenter", "ip_dedicated": true },
      "locations": [{ "country": "JP", "city": "Tokyo" }, { "country": "SG" }],
      "access": { "root": true, "ssh": true, "vnc": true, "custom_software": true },
      "prices": [
        { "amount": 99, "currency": "USD", "period": "month", "vat_included": false },
        { "amount": 6, "currency": "USD", "period": "day", "vat_included": false }
      ],
      "stock": "in_stock",
      "url": "https://example.com/order/m4"
    }
  ],
  "deals": [
    { "id": "double-11", "title": "双十一首月 8 折", "code": "CM11", "url": "https://example.com/promo", "expires_at": "2026-11-12" }
  ],
  "affiliate": { "url": "https://example.com/?aff=cloudmac", "terms": "首单 20%" }
}