组织

组织是Capgo中的顶级实体。它们允许您将应用程序、团队成员和资源组合在一个单独的帆布下。每个组织都可以有多个具有不同角色和权限的成员。

常见用例

• 为您的公司创建一个新的组织
• 管理组织设置
• 更新组织信息
• 获取组织详细信息

API端点

GET

https://api.capgo.app/organization/

如果传入参数，则返回单个组织。否则，返回所有可访问的组织。 orgId 查询参数

查询参数

• orgId (optional): 需要检索的特定组织的 ID

响应类型

interface Organization {
  id: string
  created_by: string
  created_at: string
  updated_at: string
  logo: string | null
  name: string
  management_email: string
  customer_id: string | null
}

示例请求

# Get all organizations
curl -H "x-api-key: YOUR_API_KEY" https://api.capgo.app/organization/

# Get specific organization
curl -H "x-api-key: YOUR_API_KEY" https://api.capgo.app/organization/?orgId=org_123

示例响应

{
  "data": {
    "id": "org_123",
    "name": "My Company",
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z",
    "logo": "https://example.com/logo.png",
    "management_email": "admin@example.com",
    "customer_id": "cus_123"
  }
}

POST

https://api.capgo.app/organization/

创建一个新组织

当使用一个 API 密钥时，密钥必须具有全局权限和当前组织范围的 org.create 或 org_admin 绑定。这是必需的，因为目标组织尚未存在，因此无法使用正常的组织范围RBAC检查它。 org_super_admin 当请求成功时，__CAPGO_KEEP_0__ 将自动将同一个 __CAPGO_KEEP_1__ 密钥赋予新组织。

When the request succeeds, Capgo automatically assigns the same API key as org_super_admin 注意

允许创建组织

org.create is not granted to new API keys by default. Enable 创建组织 在 API 键的形式中，或包含 "global_permissions": ["org.create"] 通过 API 创建键时

请求体

interface OrganizationCreate {
  name: string
  email?: string
  estimatedMau?: number
  website?: string
}

示例请求

curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "New Organization",
    "email": "admin@example.com",
    "website": "https://example.com"
  }' \
  https://api.capgo.app/organization/

示例响应

{
  "id": "org_456"
}

Permission Error

如果API键没有 org.create，API返回：

{
  "error": "permission_denied"
}

PUT

https://api.capgo.app/organization/

Update an existing organization. Requires admin role on the target organization.

Request Body

interface OrganizationUpdate {
  orgId: string
  logo?: string
  name?: string
  management_email?: string
}

Example Request

curl -X PUT \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "name": "New Company Name",
    "management_email": "newemail@example.com"
  }' \
  https://api.capgo.app/organization/

示例响应

{
  "status": "Organization updated",
  "data": {
    "id": "org_123",
    "name": "New Company Name",
    "management_email": "newemail@example.com"
  }
}

DELETE

https://api.capgo.app/organization/

删除现有的组织。需要在目标组织上删除权限，通常通过角色。这个动作不可逆转，会移除所有相关的应用、捆绑包（版本）和资源。 org_super_admin 全局权限不允许删除组织。

DELETE org.create Section titled “DELETE”

请求参数

• orgId: 需要删除的组织的 ID

示例请求

curl -X DELETE \
  -H "x-api-key: YOUR_API_KEY" \
  https://api.capgo.app/organization/?orgId=org_123

示例响应

{
  "status": "ok"
}

错误处理

常见错误场景及其响应:

// Invalid API key
{
  "error": "Invalid API key",
  "status": "KO"
}

// Missing required field
{
  "error": "Name is required",
  "status": "KO"
}

// Insufficient permissions
{
  "error": "Admin role required",
  "status": "KO"
}

最佳实践

1. 命名: 为组织使用清晰、描述性的名称
2. : 为团队成员分配适当的角色: 使用一个群组邮箱来避免因个人邮箱变化而导致的问题
3. : 在可靠的CDN上托管Logo并使用HTTPS URL__CAPGO_KEEP_0__
4. __CAPGO_KEEP_1____CAPGO_KEEP_2__

继续从组织中前进

如果您正在使用 组织 来规划仪表板和API操作， API概览 查看API概览中的实施细节 介绍 查看介绍中的实施细节 API密钥 查看API密钥中的实施细节 设备 为设备中的实现细节 Bundles 为Bundles中的实现细节