デベロッパー カテゴリを管理する

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

デベロッパー カテゴリとは、同様の特性を持つデベロッパーまたは会社のグループです。 特定のカテゴリで動作するように収益化を構成できます。たとえば、 は、収益分配対象のアプリを開発するすべてのデベロッパーに適用される料金プランを作成できます。 「revenue_sharing」というデベロッパー カテゴリを開発者を追加します。詳細 デベロッパー カテゴリを使用して料金プランを作成する方法については、料金プランを作成するをご覧ください。

[Developer Categories] ページの詳細

以下のセクションで説明するように、Edge UI または Classic Edge UI を使用して [Developer Categories] ページにアクセスします。

デベロッパー カテゴリの追加

UI を使用してデベロッパー カテゴリを追加するには:

1. [Develop Categories] ページにアクセスします。
2. [+ Developer Category] をクリックします。
3. 新しいカテゴリの名前と簡単な説明を入力します。
4. [Create Developer Category] をクリックします。

会社をデベロッパー カテゴリに追加する

会社をデベロッパー カテゴリに追加します。会社は 1 つのデベロッパー カテゴリにのみ所属できます。

会社をデベロッパー カテゴリに追加するには:

1. [公開 >[Companies] をクリックします。
2. デベロッパー カテゴリに追加する会社を選択します。
3. 会社のページで [編集] をクリックします。
4. 会社の [Developer Category] を選択します。
5. [保存] をクリックします。
   

デベロッパー カテゴリの編集

UI を使用してデベロッパー カテゴリを編集するには:

1. [Develop Categories] ページにアクセスします。
2. 編集するデベロッパー カテゴリにカーソルを合わせて、 をクリックします。
3. デベロッパー カテゴリを入力します。
4. [Update Developer Category] をクリックします。

デベロッパー カテゴリを削除する

UI を使用してデベロッパー カテゴリを削除するには:

1. [Develop Categories] ページにアクセスします。
2. 編集するデベロッパー カテゴリにカーソルを合わせます。
3. [] をクリックします。
4. [Delete] をクリックして削除操作を確定します。

API を使用したデベロッパー カテゴリの管理

ここでは、API を使用してデベロッパー カテゴリを管理する方法について説明します。

API を使用してデベロッパー カテゴリを追加する

デベロッパー カテゴリを追加するには、POST リクエストを /mint/organizations/{org_name}/developer-categories。

リクエストを発行するときに、カテゴリ name を指定します。 ペイロード内の description。例:

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}

1 つの会社やデベロッパーは、1 つのデベロッパー カテゴリにのみ所属できます。

リクエスト本文の属性として MINT_DEVELOPER_CATEGORY を指定します。 カテゴリの内部 ID を指定します。たとえば、次のリクエストでは、既存の をデベロッパー カテゴリ「Gold」に割り当てます。カテゴリには 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} は、デベロッパー カテゴリを識別する 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

組織のすべての API デベロッパー カテゴリを表示するには、次の宛先に GET リクエストを発行します。 /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 です。リクエスト本文で、更新した設定とデベロッパーの 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} は、削除するデベロッパー カテゴリを識別する 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 を使用して設定できる構成プロパティをまとめたものです。