管理开发者类别

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

开发者类别是一组具有类似特征的开发者或公司, 您可以配置获利功能,以针对该特定类别运作。例如,您 可以制定适用于开发应用收益分成的所有开发者的费率方案,具体方法如下: 创建名为“revenue_sharing”的开发者类别以及添加开发者有关 如需了解如何根据开发者类别创建价格方案,请参阅创建价格方案

浏览“开发者类别”页面

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

Edge 界面

要访问“开发类别”页面,请执行以下操作:

  1. 登录 apigee.com/edge
  2. 选择发布 >创收 >“开发者类别”

系统随即会显示“开发者类别”页面。

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

传统 Edge(私有云)

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

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

系统随即会显示“开发者类别”页面。

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

添加开发者类别

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

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

将公司添加到开发者类别

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

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

  1. 选择发布 >公司
  2. 选择要添加到开发者类别的公司。
  3. 点击公司页面上的修改
  4. 选择公司的开发者类别
  5. 点击保存

修改开发者类别

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

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

删除开发者类别

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

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

使用 API 管理开发者类别

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

使用 API 添加开发者类别

添加开发者类别,只需向 发出 POST 请求即可 /mint/organizations/{org_name}/developer-categories

发出请求时,请指定类别 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 查看开发者类别

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

向特定开发者类别发出 GET 请求可查看特定的开发者类别 /mint/organizations/{org_name}/developer-categories/{category_id},其中 {category_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。例如:

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

使用 API 修改开发者类别

如需修改开发者类别,请向以下用户发出 PUT 请求: /mint/organizations/{org_name}/developer-categories/{category_id},其中 {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 删除开发者类别

向 发出 DELETE 请求,以删除开发者类别 /mint/organizations/{org_name}/developer-categories/{category_id},其中 {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。

不适用 是,以便设置开发者类别。