用途:通过 Railway 公共 GraphQL API 管理项目、服务、部署、环境和变量。请求统一发送至 https://backboard.railway.com/graphql/v2,均以 POST 提交,使用账户或工作区令牌作为 Bearer 头:Authorization: Bearer $RAILWAY_TOKEN。账户令牌覆盖用户所属全部工作区;工作区令牌限定单个工作区,但查询/变更接口一致。环境级自动化应改用单独的 railway-project 技能(其发送 Project-Access-Token,作用域规则不同)。
主要能力:验证身份(query { me { id name email } });通过内省查询发现 schema;列出/获取项目(含服务与环境);列出某服务的部署;重新部署(deploymentRedeploy);从最新版本触发新部署(serviceInstanceDeployV2);读取与 upsert 变量(variables、variableUpsert)。连接类型使用 edges { node { ... } } 游标分页。
使用方式:把请求体写入 /tmp/railway_request.json,用 -d @/tmp/railway_request.json 引用,避免在 shell 中内联 GraphQL 字符串。示例:curl -s -X POST "https://backboard.railway.com/graphql/v2" --header "Authorization: Bearer $RAILWAY_TOKEN" --header "Content-Type: application/json" -d @/tmp/railway_request.json。请求失败时可运行 zero doctor check-connector --env-name RAILWAY_TOKEN 或 zero doctor check-connector --url https://backboard.railway.com/graphql/v2 --method POST。官方文档:https://docs.railway.com/reference/public-api。
限制与注意:构造新查询前先对相关类型做内省,schema 会演进且 API 不版本化;顶层 errors 数组返回错误对象,需解析并呈现,不能仅凭 200 状态判断成功;令牌泄露风险——切勿将 $RAILWAY_TOKEN 输出到日志、文件或 shell 输出。其余如价格、配额等信息暂未提供。