管理开发者类别

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

开发者类别是一组具有类似特征的开发者或公司,您可以通过它们配置变现模式以针对该特定类别开展业务。例如,您可以创建适用于开发收益分成应用的开发者的费率方案,只需创建一个名为“revenue_sharing”的开发者类别并将开发者添加到该类别即可。如需详细了解如何根据开发者类别创建费率方案,请参阅创建费率方案

探索“开发者类别”页面

使用 Edge 界面或传统版 Edge 界面访问“开发者类别”页面,如以下部分所述。

Edge 界面

如需访问“开发类别”页面,请按以下步骤操作:

  1. 登录 apigee.com/edge
  2. 在左侧导航栏中,依次选择发布 > 创收 > 开发者类别

此时会显示“开发者类别”页面。

如图所示,通过“开发者类别”页面,您可以:

传统 Edge (Private Cloud)

如需使用传统版 Edge 界面访问“开发类别”页面,请执行以下操作:

  1. 登录 http://ms-ip:9000,其中 ms-ip 是管理服务器节点的 IP 地址或 DNS 名称。
  2. 在顶部导航栏中,依次选择发布 > 开发者类别

此时会显示“开发者类别”页面。

在“开发者类别”页面上,您可以:

添加开发者类别

如需使用界面添加开发者类别,请执行以下操作:

  1. 访问“开发类别”页面
  2. 点击 + 开发者类别
  3. 输入新类别的名称和简短说明。
  4. 点击创建开发者类别

将公司添加到开发者类别

将公司添加到开发者类别。一家公司只能属于一个开发者类别。

若要将公司添加到开发者类别,请按以下步骤操作:

  1. 在顶部导航栏中,依次选择发布 > 公司
  2. 选择您要添加到开发者类别的公司。
  3. 点击公司页面上的 Edit(修改)。
  4. 选择该公司的开发者类别
  5. 点击保存

修改开发者类别

如需使用界面修改开发者类别,请执行以下操作:

  1. 访问“开发类别”页面
  2. 将光标放在要修改的开发者类别上,然后点击
  3. 输入开发者类别。
  4. 点击更新开发者类别

删除开发者类别

如需使用界面删除开发者类别,请执行以下操作:

  1. 访问“开发类别”页面
  2. 将光标放在要修改的开发者类别上。
  3. 点击
  4. 点击删除以确认操作。

使用 API 管理开发者类别

您可以使用 API 管理开发者类别,如以下部分所述。

使用 API 添加开发者类别

通过向 /mint/organizations/{org_name}/developer-categories 发出 POST 请求来添加开发者类别。

发出请求时,请在载荷中指定类别 namedescription。例如:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Content-Type:application/json"  \
  -d '{
    "name": "Gold",
    "description": "Gold membership"
  }' \
  -u email:password

应返回如下所示的内容:

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

使用 API 将开发者或公司添加到开发者类别

在添加或修改公司或开发者(通过分别向以下资源发出 POST 请求)时,将开发者或公司添加到开发者类别:

  • /organizations/{org_name}/companies
  • /organizations/{org_name}/developers

如需在修改公司或开发者类别时将开发者或公司添加到开发者类别,请分别向以下资源发出 PUT 请求:

  • /organizations/{org_name}/companies/{company_id}
  • /organizations/{org_name}/developers/{developer_id}

一个公司或开发者只能属于一个开发者类别。

在请求正文中将 MINT_DEVELOPER_CATEGORY 指定为属性,并将类别内部 ID 作为值。例如,以下请求将一个现有的开发者添加到名为“黄金”的开发者类别(ID 为 aa6f960a-d9fd-416e-be39-c071418aabd0)中。

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \
  -H "Content-Type: application/json" \
  -d '{
   "email" : "developer@apigee.com",
    "developerId" : "K4jW2QLjZ1h8GFA8",
    "firstName" : "Dev",
    "lastName" : "One",
    "userName" : "devone",    
    "attributes" : [ {
      "name" : "MINT_REGISTRATION_ID",
      "value" : "dev1"
    }, {
      "name" : "MINT_DEVELOPER_LEGAL_NAME",
      "value" : "DEV ONE"
    }, {
      "name" : "MINT_DEVELOPER_TYPE",
      "value" : "TRUSTED"
    }, {
      "name" : "MINT_BILLING_TYPE",
      "value" : "PREPAID"
    }, {
      "name" : "MINT_IS_BROKER",
      "value" : "TRUE"
    }, {
      "name" : "MINT_DEVELOPER_CATEGORY",
      "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0"
    }, {
      "name" : "MINT_DEVELOPER_ADDRESS",
      "value" : "{
                   "address1": "Dev One Address",
                   "city": "Pleasanton",
                   "country": "US",
                   "isPrimary": "true",
                   "state": "CA",
                   "zip": "94588"
                }"
    }
  }' \
  -u email:password

使用 API 查看开发者类别

查看特定开发者类别或某个组织中的所有开发者类别。

/mint/organizations/{org_name}/developer-categories/{category_id} 发出 GET 请求即可查看特定的开发者类别,其中 {category_id} 是开发者类别的标识(添加开发者类别后,系统会在响应中返回该 ID)。例如:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

/mint/organizations/{org_id}/developer-categories 发出 GET 请求,以查看组织的所有 API 开发者类别。例如:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Accept:application/json" \
  -u email:password

使用 API 修改开发者类别

通过向 /mint/organizations/{org_name}/developer-categories/{category_id} 发出 PUT 请求来修改开发者类别,其中 {category_id} 是要更新的类别的标识。您需要在请求正文中指定更新后的设置以及开发者类别的 ID。例如,以下请求会修改开发者类别的说明:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Content-Type: application/json"  \
  -d '{
    "id": "aa6f960a-d9fd-416e-be39-c071418aabd0",
    "description": "Premium membership"
  }' \
  -u email:password

使用 API 删除开发者类别

通过向 /mint/organizations/{org_name}/developer-categories/{category_id} 发出 DELETE 请求来删除开发者类别,其中 {category_id} 是要删除的开发者类别的标识。例如:

curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

API 的开发者类别配置属性

下表总结了可使用 API 设置的配置属性。

名称 说明 默认 是否必需?
name

媒体资源名称。设置为 MINT_DEVELOPER_CATEGORY。

不适用
value

开发者所属的开发者类别的 ID。

不适用 是,为了设置开发者类别。