Admin API

Admin 接口需要 /v1/admin/auth/login 返回的 admin JWT（pb_adm_*）。普通用户 JWT（pb_usr_*）、API key 和 server key 都不能访问浏览器后台接口。

Admin 用户存放在独立的 admin_users 表里。首次管理员需要通过 CLI 创建：

PRINTBASE_PG_DSN='postgres://user:pass@127.0.0.1:5432/printbase?sslmode=disable' \
go run ./cmd/adminctl create-admin --email admin@example.com --password 'Passw0rd!'

Admin 登录

• POST /v1/admin/auth/login 返回 pb_adm_* token。
• GET /v1/admin/auth/me 返回当前 admin 资料和 scopes。

企业管理

• GET /v1/admin/enterprises 查看企业列表。
• GET /v1/admin/enterprises/{id} 查看企业、组织、成员和用量统计。
• PATCH /v1/admin/enterprises/{id} 更新企业基础资料，需要 admin:write。
• GET /v1/admin/organizations 查看跨企业组织列表，并返回企业摘要字段。
• GET /v1/admin/enterprises/{id}/organizations 查看企业下组织。

组织资源

使用 GET /v1/admin/organizations/{org_id}/{resource}，resource 可选：

• print-jobs
• printers
• computers
• api-keys
• webhooks
• billing

print-jobs 支持可选 status 查询参数。

Enterprise 申请审核

• GET /v1/admin/enterprise-applications?status=pending
• GET /v1/admin/enterprise-applications/{id}
• POST /v1/admin/enterprise-applications/{id}/approve
• POST /v1/admin/enterprise-applications/{id}/reject

申请审核需要 enterprise_applications:read 或 enterprise_applications:write。