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

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します。 info

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

[Developer Categories] ページを確認する

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

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

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

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

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

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

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

1. 上部のナビゲーション バーで、[Publish > Companies] を選択します。
2. デベロッパー カテゴリに追加する会社を選択します。
3. 会社のページで [Edit] をクリックします。
4. 会社のデベロッパー カテゴリ を選択します。
5. [Save] をクリックします。
   

デベロッパー カテゴリを編集する

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

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

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

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

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

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

次のセクションで説明するように、API を使用してデベロッパー カテゴリを管理します。

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

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

リクエストを発行する場合は、ペイロードにカテゴリの 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 つのデベロッパー カテゴリにのみ所属できます。

リクエスト本文で、カテゴリの内部 ID を値として MINT_DEVELOPER_CATEGORY を属性として指定します。たとえば、次のリクエストでは、既存の デベロッパーを、「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 を使用してデベロッパー カテゴリを表示する

特定のデベロッパー カテゴリまたは組織内のすべてのデベロッパー カテゴリを表示します。

特定のデベロッパー カテゴリを表示するには、 /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

組織のすべての API デベロッパー カテゴリを表示するには、 /mint/organizations/{org_id}/developer-categories に GET リクエストを発行します。次に例を示します。

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 を使用してデベロッパー カテゴリを削除する

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 を使用して設定できる構成プロパティの概要を示します。