{"name":"VibrantLink China cloud application form","schemaVersion":"2026-11-19","description":"面向获得用户授权的智能体或 AI 助手的机器可读说明。提交前必须取得用户对真实资料、条款和跨境单独同意的明确授权。","formPage":"/chinacloudapply","humanGuide":"/agents","capabilityMatrix":{"page":"/resources/cn-capability-matrix","json":"/api/agent/capability-matrix","mcpTool":"get_photon_china_capability_matrix","note":"中国区 SDK/产品状态、核对时间、验证依据和官方文档入口。"},"mcp":{"endpoint":"/api/mcp","alias":"/mcp","discovery":"/api/agent/tools","transport":"JSON-RPC 2.0 over HTTP POST；支持 initialize、tools/list、tools/call。","readOnlyHeaders":"状态查询不需要 X-Agent-Name 或授权头。","submitAuthorization":"提交工具必须携带 X-Agent-Authorization: user-consented，或在参数中提供 agentAuthorization: user-consented。"},"endpoint":{"url":"/api/applications","method":"POST","contentType":"application/json","maxBodyBytes":65536,"cors":"Access-Control-Allow-Origin: * (no credentials)"},"precheckEndpoint":{"url":"/api/applications/duplicate-check","method":"POST","body":{"appId":"准备提交的 AppID","photonAccountEmail":"申请时使用的 Photon 账号邮箱"},"returns":"200 { ok:true, duplicate:false } 或 409 { code:'duplicate_app_id', status?, message }；账号不匹配时不返回状态细节。","note":"人类表单在第一步使用；只读/防重复检查，不创建申请。每 IP / X-Client-Id 30 次 / 10 分钟；同时计入同一 IP 120 次 / 10 分钟、同一 /24 或 /64 网段 600 次 / 10 分钟的总限额。"},"requiredHeaders":{"X-Agent-Name":"智能体名称或标识，建议提供。提供该请求头时，必须同时提供 X-Agent-Authorization: user-consented。","X-Agent-Authorization":"user-consented（仅在提供 X-Agent-Name 时必需）"},"optionalHeaders":{"X-Client-Id":"可选的稳定浏览器/客户端标识（8–100 个安全字符）。用于与 IP 一起限流和识别重复提交；网页表单会自动生成。"},"agentRequirements":["仅在你已获得用户明确授权后，代用户提交申请。","授权声明先于字段校验：提供 X-Agent-Name 但缺少 X-Agent-Authorization: user-consented 时，服务端会在解析字段前返回 403。","只提交用户提供或确认的真实资料；不得编造姓名、AppID、邮箱或项目内容；主观项可以留空，不要猜。","不得收集或提交 Photon 账号密码、邮箱密码、支付卡号或短信验证码。","用户必须已阅读并同意使用与许可条款；提交时 terms 必须为 true。","用户必须已单独阅读跨境个人信息提供告知，并同意向 Exit Games（包括向中国境外）提供个人信息；提交时 crossBorderConsent 必须为 true。缺少该字段或为 false 时返回明确的 422 错误。","每个 IP 与浏览器标识在 10 分钟内最多 8 次提交尝试（含字段错误请求）；超过后返回 429 并同时提供 Retry-After 头与 retryAfter 秒数。","公开提交、重复预检与自动化访问共同受共享 IP / 网段总限额约束：同一 IP 120 次 / 10 分钟，同一 /24 或 /64 网段 600 次 / 10 分钟；请遵守限流并不要通过轮换 IP 或网段规避。","申请提交接口不使用图片验证码，使用蜜罐、频率限制与内容校验；验证码只用于网页版 AppID 状态查询。不得绕过任何验证码、访问后台接口、批量测试免费额度或提交他人信息。","同一 AppID 已存在记录时返回 409；如 Photon 账号匹配，会返回该 AppID 的状态提示；账号不匹配时不返回状态细节，避免泄露。","如果字段校验失败，请把 errors 中的提示反馈给用户并等待补充，不要自行伪造。"],"apiContract":{"asIs":"接口、字段、枚举、错误码与 MCP tools 按现状提供。","changes":"可能因产品、安全、法律或运营需要变更；重大变更通过站内说明、schemaVersion、/agents 或 /llms.txt 公布。","noWarranty":"遵守某一版本 schema 不构成对兼容性、可用性、持续支持或服务等级的承诺，也不构成要约。"},"captcha":{"required":false,"appliesTo":"/api/applications","note":"提交申请不需要 captcha 字段；网页版 POST /api/applications/status 才需要 captchaToken 与 captchaAnswer。"},"statusEndpoint":{"url":"/api/agent/application-status","method":"POST","contentType":"application/json","cors":"Access-Control-Allow-Origin: * (no credentials)","body":{"reference":"提交申请返回的 reference，形如 VB-YYYYMMDD-A1B2C3（后缀为十六进制字符）","appId":"申请时提交的 AppID","photonAccountEmail":"申请时使用的 Photon 账号邮箱"},"headers":{"required":[],"note":"只读查询不需要 X-Agent-Name 或 X-Agent-Authorization；携带它们也不会改变结果。"},"returns":"status, label, description, submittedAt, updatedAt；不返回申请人或项目资料。","note":"三项必须同时匹配；无需图片验证码。每 IP 30 次 / 10 分钟，同一申请 10 次 / 10 分钟。公开申请列表仍仅限管理员，不提供公开 GET /api/applications。"},"tools":[{"name":"submit_photon_cloud_application","description":"提交一份获得用户授权的中国区光子云申请。","method":"POST","url":"/api/applications","contentType":"application/json","requiredHeaders":["X-Agent-Name","X-Agent-Authorization: user-consented"],"optionalHeaders":["X-Client-Id"],"requiredFields":["applicant","photonAccountEmail","appType","appId","occupation","projectSummary","projectStage","projectType","discoveredVia","terms","crossBorderConsent"],"optionalFields":["satisfaction","wouldRecommend"],"returns":"201 { ok, reference, message }；字段错误 422；重复 AppID 409；超限 429 + Retry-After。","mcp":"tools/call submit_photon_cloud_application"},{"name":"get_photon_cloud_application_status","description":"用 reference、appId 和申请账号邮箱查询申请状态；不返回申请人资料。只读接口不需要智能体请求头。","method":"POST","url":"/api/agent/application-status","contentType":"application/json","requiredHeaders":[],"requiredBody":["reference","appId","photonAccountEmail"],"returns":"200 { ok, reference, appId, status, label, description, submittedAt, updatedAt }","mcp":"tools/call get_photon_cloud_application_status"}],"conditionalRules":["当 appType 为 Photon Voice 时，voiceAck 必填，值为“好的，我了解了”或“好的，希望未来依旧可以提供云服务”。","当 occupation 为 在校学生 时，school 可选；其他职业下不要提交 school。","当 discoveredVia 为 浏览技术论坛或社区 或 网上软件或技术教程 时，discoveredSite 可选；其他渠道下不要提交。"],"fields":[{"name":"applicant","type":"string","required":true,"minLength":2,"maxLength":80,"description":"申请人、工作室或公司名称。"},{"name":"photonAccountEmail","type":"string","format":"email","required":true,"description":"Photon 全球站点账号邮箱，用于核对和开通。"},{"name":"appType","type":"string","required":true,"enum":["Photon Realtime","Photon PUN","Photon Fusion","Photon Quantum","Photon Chat","Photon Voice"],"description":"中国区项目对应的 Photon 产品。"},{"name":"appId","type":"string","required":true,"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"标准 GUID，格式 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx（8-4-4-4-12，大小写不敏感）。"},{"name":"voiceAck","type":"string","required":false,"enum":["好的，我了解了","好的，希望未来依旧可以提供云服务"],"description":"仅当 appType 为 Photon Voice 时必填。"},{"name":"occupation","type":"string","required":true,"enum":["在校学生","专职游戏开发","专职技术开发","业余爱好"]},{"name":"school","type":"string","required":false,"maxLength":100,"description":"当职业为在校学生时可填写。"},{"name":"projectSummary","type":"string","required":true,"minLength":10,"maxLength":1000,"description":"项目的真实简介、2D/3D、当前阶段与免费额度的用途。"},{"name":"projectStage","type":"string","required":true,"enum":["未立项","已立项","已经处于正式开发中"]},{"name":"projectType","type":"string","required":true,"enum":["FPS/TPS","MMORPG/其他MMO","ARPG/ACT/FTG","SLG/RPG/AVG/SIM","RTS","TABLE/PUZ/MUG","RAC/SPG","ETC其他或非游戏类型"]},{"name":"projectUrl","type":"string","required":false,"format":"uri","maxLength":500,"description":"http(s) 项目链接、Demo 或视频地址。"},{"name":"discoveredVia","type":"string","required":true,"enum":["浏览技术论坛或社区","网上软件或技术教程","学校课程，同学或老师推荐","其他工作室或开发者推荐"]},{"name":"discoveredSite","type":"string","required":false,"format":"uri","maxLength":500,"description":"了解渠道为技术论坛/社区或教程时可填写。"},{"name":"wouldRecommend","type":"string","required":false,"enum":["好的，举手之劳","我需要再考虑一下"],"description":"主观项，可留空；如填写，只能使用给定枚举。"},{"name":"contactEmail","type":"string","required":false,"format":"email","maxLength":254},{"name":"phone","type":"string","required":false,"maxLength":30,"description":"真实联系电话；至少 7 位数字。"},{"name":"feedback","type":"string","required":false,"maxLength":1000},{"name":"satisfaction","type":"integer","required":false,"minimum":1,"maximum":5,"description":"主观项，可留空；如填写，为用户对当前 Photon 产品体验的真实评分。"},{"name":"terms","type":"boolean","required":true,"const":true,"description":"用户已阅读并同意条款时必须为 true。"},{"name":"crossBorderConsent","type":"boolean","required":true,"const":true,"description":"用户已单独同意将其个人信息提供给 Exit Games（包括向中国境外提供）时必须为 true；必须先向用户展示跨境个人信息提供告知。"},{"name":"website","type":"string","required":false,"description":"蜜罐字段，智能体与用户都必须留空。"}],"terms":{"title":"光子引擎中文站使用与许可条款","version":"1.2","effectiveDate":"2026-11-18","url":"/terms","crossBorderNotice":{"title":"跨境个人信息提供告知","version":"2026-11-18","url":"/privacy/cross-border"}},"responses":{"201":{"ok":true,"reference":"VB-YYYYMMDD-A1B2C3","message":"申请已收到…"},"403":{"ok":false,"message":"智能体未声明用户授权。"},"409":{"ok":false,"code":"duplicate_app_id","message":"该 AppID 已提交过；账号匹配时返回状态提示，账号不匹配时只返回通用提示。"},"422":{"ok":false,"message":"字段校验失败；错误信息为中文。","errors":{"field":"原因"}},"429":{"ok":false,"message":"提交过于频繁；按 IP 与浏览器标识每 10 分钟最多 8 次提交尝试；提交与重复预检共享同一 IP 120 次 / 10 分钟、同一 /24 或 /64 网段 600 次 / 10 分钟的总预算。","retryAfter":"Retry-After header (seconds)"}},"privacy":"申请资料仅用于审核、开通和支持；为防滥用会记录真实 IP 地址（IPv4/IPv6）、浏览器标识与 User-Agent。向 Exit Games 提供个人信息（包括跨境提供）须取得单独同意；参见 /terms 第 10 节与 /privacy/cross-border。","contact":{"channel":"QQ","note":"通过站内 QQ 咨询入口联系；需先阅读并同意咨询与许可确认。"}}