API 参考 后台服务
创建服务
POST/projects/{project_id}/services/
创建后台服务——响应项目状态变化的脚本。
参数
| 请求体字段 | 必填 | 说明 |
|---|---|---|
| name | 必填 | 显示名 |
| script | 可选 | 服务源码——定义 on_change 处理器 |
| script_language | 可选 | python（默认）或 typescript |
| description | 可选 | 该服务响应什么 |
| workspace_id | 可选 | 处理器运行所在的工作区 |
| docker_image_id | 可选 | 处理器的自定义环境 |
| trigger_stores | 可选 | 要监听的状态 store 名称；空 = 响应全部 |
| enabled | 可选 | 响应开/关（默认 true） |
请求
curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/services/" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"
-d '{
"name": "deploy-watcher",
"script_language": "python",
"script": "def on_change(mutation, state):\n ...",
"trigger_stores": ["project_status_deploy"]
}'