API 参考 / projects

当前项目壳(Host 解析)

GET /api/v1/projects/current · getCurrentProject

由请求 Host 解析项目,返回项目壳信息与当前用户在该项目的成员/角色上下文。

Host 不指向任何项目子域时(中央面 workflow.games、运营面 admin.workflow.games) 返回 204 No Content:那里本来就没有「当前项目」,是正常状态而非错误。 404 只留给「Host 指向某个项目子域,但该项目不存在或未开通」。

鉴权:项目 API Token(Authorization: Bearer wfp_…)。详见 Agent 接入。

响应字段 · 200

project(必填)
ProjectSummary
project.id(必填)
string
project.name(必填)
string
project.description
string
project.program
string
project.subdomainPrefix(必填)
string
project.orgId(必填)
string
project.status(必填)
enum;取值:provisioning / active / failed / frozen
project.onboardingCompletedAt
string
project.memberCount(必填)
integer
project.createdAt(必填)
string
project.ownerName
string
membership(必填)
ProjectMember
membership.userId(必填)
string
membership.email(必填)
string
membership.displayName
string
membership.avatarUrl
string
membership.feishuStatus
enum;取值:unbound / bound / invalid
membership.feishuHandle
string
membership.department
string
membership.roleId(必填)
string
membership.roleName(必填)
string
membership.status(必填)
enum;取值:active / left
membership.permissions(必填)
string[] —— 该成员所属角色的项目治理能力项;业务模块读写权限见 moduleAccess。
membership.moduleAccess(必填)
ModuleAccess —— 角色对六个业务模块的访问等级;六键均必填,不允许部分下发。词表与项目侧边导航一一对应(B-00186)。
membership.moduleAccess.requirements(必填)
enum;取值:none / read / edit / manage
membership.moduleAccess.rooms(必填)
enum;取值:none / read / edit / manage
membership.moduleAccess.schedule(必填)
enum;取值:none / read / edit / manage
membership.moduleAccess.bugs(必填)
enum;取值:none / read / edit / manage
membership.moduleAccess.milestones(必填)
enum;取值:none / read / edit / manage
membership.moduleAccess.documents(必填)
enum;取值:none / read / edit / manage
membership.joinedAt
string
onboardingCompleted
boolean
publicDemo
boolean

响应 · 204

当前 Host 没有对应项目(中央面 / 运营面),无内容可返回

错误

请求示例(curl)

curl -X GET "https://你的项目.workflow.games/api/v1/projects/current" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "project": {
    "id": "018f3c2e-0000-7000-8000-000000000000",
    "name": "示例标题",
    "subdomainPrefix": "示例文本",
    "orgId": "018f3c2e-0000-7000-8000-000000000000",
    "status": "provisioning",
    "memberCount": 1,
    "createdAt": "示例文本"
  },
  "membership": {
    "userId": "018f3c2e-0000-7000-8000-000000000000",
    "email": "[email protected]",
    "roleId": "018f3c2e-0000-7000-8000-000000000000",
    "roleName": "示例标题",
    "status": "active",
    "permissions": [
      "示例文本"
    ],
    "moduleAccess": {
      "requirements": "none",
      "rooms": "none",
      "schedule": "none",
      "bugs": "none",
      "milestones": "none",
      "documents": "none"
    }
  },
  "onboardingCompleted": true
}

合同真值:OpenAPI 3.1(0.1.0)。

相关:Agent 接入指南 · 使用指南 · API 参考索引

Workflow 正在加载…