Entwicklerkategorien verwalten

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

Eine Entwicklerkategorie ist eine Gruppe von Entwicklern oder Unternehmen mit ähnlichen Merkmalen, mit der Sie die Monetarisierung für diese bestimmte Kategorie konfigurieren können. Sie können beispielsweise Tarife erstellen, die für alle Entwickler gelten, die Apps mit Umsatzbeteiligung entwickeln. Dazu erstellen Sie eine Entwicklerkategorie namens „revenue_sharing“ und fügen ihr Entwickler hinzu. Weitere Informationen zum Erstellen von Preisplänen mit Entwicklerkategorien finden Sie unter Preispläne erstellen.

Die Seite „Entwicklerkategorien“ kennenlernen

Rufen Sie die Seite „Entwicklerkategorien“ über die Edge-Benutzeroberfläche oder die Classic Edge-Benutzeroberfläche auf, wie in den folgenden Abschnitten beschrieben.

Entwicklerkategorie hinzufügen

So fügen Sie eine Entwicklerkategorie über die Benutzeroberfläche hinzu:

1. Rufen Sie die Seite Kategorien entwickeln auf.
2. Klicken Sie auf + Entwicklerkategorie.
3. Geben Sie einen Namen und eine kurze Beschreibung für die neue Kategorie ein.
4. Klicken Sie auf Entwicklerkategorie erstellen.

Unternehmen einer Entwicklerkategorie hinzufügen

Fügen Sie einer Entwicklerkategorie ein Unternehmen hinzu. Ein Unternehmen kann nur einer Entwicklerkategorie angehören.

So fügen Sie einer Entwicklerkategorie ein Unternehmen hinzu:

1. Wählen Sie in der oberen Navigationsleiste Veröffentlichen > Unternehmen aus.
2. Wählen Sie das Unternehmen aus, das Sie der Entwicklerkategorie hinzufügen möchten.
3. Klicken Sie auf der Unternehmensseite auf Bearbeiten.
4. Wählen Sie die Entwicklerkategorie für das Unternehmen aus.
5. Klicken Sie auf Speichern.
   

Entwicklerkategorie bearbeiten

So bearbeiten Sie eine Entwicklerkategorie über die Benutzeroberfläche:

1. Rufen Sie die Seite Kategorien entwickeln auf.
2. Bewegen Sie den Mauszeiger auf die Entwicklerkategorie, die Sie bearbeiten möchten, und klicken Sie auf .
3. Geben Sie die Entwicklerkategorie ein.
4. Klicken Sie auf Entwicklerkategorie aktualisieren.

Entwicklerkategorie löschen

So löschen Sie eine Entwicklerkategorie über die Benutzeroberfläche:

1. Rufen Sie die Seite Kategorien entwickeln auf.
2. Bewegen Sie den Mauszeiger auf die Entwicklerkategorie, die Sie bearbeiten möchten.
3. Klicken Sie auf .
4. Klicken Sie auf Löschen, um den Vorgang zu bestätigen.

Entwicklerkategorien mit der API verwalten

Sie können Entwicklerkategorien mithilfe der API wie in den folgenden Abschnitten beschrieben verwalten.

Entwicklerkategorie mit der API hinzufügen

Senden Sie eine POST-Anfrage an /mint/organizations/{org_name}/developer-categories, um eine Entwicklerkategorie hinzuzufügen.

Wenn Sie die Anfrage senden, müssen Sie in der Nutzlast sowohl die Kategorie name als auch description angeben. Beispiel:

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

Die Antwort sollte in etwa so aussehen:

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

Entwickler oder Unternehmen mithilfe der API einer Entwicklerkategorie hinzufügen

Fügen Sie einer Entwicklerkategorie einen Entwickler oder ein Unternehmen hinzu, indem Sie das Unternehmen oder den Entwickler hinzufügen oder bearbeiten. Senden Sie dazu eine POST-Anfrage an die folgenden Ressourcen:

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

Wenn Sie beim Bearbeiten eines Unternehmens oder Entwicklers eine Entwicklerkategorie hinzufügen möchten, senden Sie eine PUT-Anfrage an die folgenden Ressourcen:

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

Ein Unternehmen oder Entwickler kann nur einer Entwicklerkategorie angehören.

Geben Sie MINT_DEVELOPER_CATEGORY als Attribut im Anfragetext mit der internen Kategorie-ID als Wert an. In der folgenden Anfrage wird beispielsweise ein bereits vorhandener Entwickler der Entwicklerkategorie „Gold“ mit der ID aa6f960a-d9fd-416e-be39-c071418aabd0 hinzugefügt.

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

Entwicklerkategorien mit der API aufrufen

Sie können sich eine bestimmte Entwicklerkategorie oder alle Entwicklerkategorien in einer Organisation ansehen.

Wenn Sie eine bestimmte Entwicklerkategorie aufrufen möchten, senden Sie eine GET-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}. {category_id} ist die Kennung der Entwicklerkategorie. Die ID wird in der Antwort zurückgegeben, wenn Sie die Entwicklerkategorie hinzufügen. Beispiel:

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

Alle API-Entwicklerkategorien für eine Organisation anzeigen, indem Sie eine GET-Anfrage an /mint/organizations/{org_id}/developer-categories senden. Beispiel:

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

Entwicklerkategorie mit der API bearbeiten

Sie können eine Entwicklerkategorie bearbeiten, indem Sie eine PUT-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id} senden. Dabei ist {category_id} die Kennung der zu aktualisierenden Kategorie. Sie müssen im Anfragetext die aktualisierten Einstellungen und die ID der Entwicklerkategorie angeben. Mit der folgenden Anfrage wird beispielsweise die Beschreibung einer Entwicklerkategorie bearbeitet:

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

Entwicklerkategorie mit der API löschen

Um eine Entwicklerkategorie zu löschen, senden Sie eine DELETE-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}. Dabei ist {category_id} die Kennung der zu löschenden Entwicklerkategorie. Beispiel:

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

Konfigurationseigenschaften der Entwicklerkategorie für die API

In der folgenden Tabelle sind die Konfigurationseigenschaften zusammengefasst, die über die API festgelegt werden können.