Entwicklerkategorien verwalten

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Eine Entwicklerkategorie ist eine Gruppe von Entwicklern oder Unternehmen mit ähnlichen Merkmalen, mit der du die Monetarisierung für diese spezifische Kategorie konfigurieren kannst. Sie können beispielsweise Preispläne erstellen, die für alle Entwickler gelten, die Apps für die Umsatzbeteiligung entwickeln. Dazu erstellen Sie eine Entwicklerkategorie mit dem Namen „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“

Rufen Sie die Seite mit den Entwicklerkategorien über die Edge-Benutzeroberfläche oder die klassische 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 Develop Categories (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 zu einer Entwicklerkategorie hinzufügen

Füge einer Entwicklerkategorie ein Unternehmen hinzu. Ein Unternehmen kann nur zu einer Entwicklerkategorie gehören.

So fügen Sie ein Unternehmen zu einer Entwicklerkategorie 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 des Unternehmens aus.
5. Klicken Sie auf Speichern.
   

Entwicklerkategorie bearbeiten

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

1. Rufen Sie die Seite Develop Categories (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 Develop Categories (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 mithilfe der API verwalten

Verwalten Sie Entwicklerkategorien mithilfe der API, wie in den folgenden Abschnitten beschrieben.

Entwicklerkategorie mithilfe der API hinzufügen

Fügen Sie eine Entwicklerkategorie hinzu, indem Sie eine POST-Anfrage an /mint/organizations/{org_name}/developer-categories senden.

Wenn Sie die Anfrage senden, geben Sie in der Nutzlast die Kategorie name und description an. 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"
}

Hinzufügen eines Entwicklers oder Unternehmens zu einer Entwicklerkategorie mithilfe der API

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

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

Wenn Sie beim Bearbeiten des Unternehmens oder Entwicklers einen Entwickler oder ein Unternehmen in eine Entwicklerkategorie aufnehmen 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. Durch die folgende 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 mithilfe der API ansehen

Eine bestimmte Entwicklerkategorie oder alle Entwicklerkategorien in einer Organisation ansehen.

Sie können sich eine bestimmte Entwicklerkategorie anzeigen lassen, indem Sie eine GET-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id} senden, wobei {category_id} die Identifizierung der Entwicklerkategorie ist (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

Sehen Sie sich alle API-Entwicklerkategorien für eine Organisation an, 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 mithilfe der API bearbeiten

Zum Bearbeiten einer Entwicklerkategorie senden Sie eine PUT-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}, wobei {category_id} die Identifizierung der zu aktualisierenden Kategorie ist. Du musst 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 mithilfe der API löschen

Eine Entwicklerkategorie löschen, indem Sie eine DELETE-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id} senden, wobei {category_id} die Identifizierung der zu löschenden Entwicklerkategorie ist. 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 Konfigurationsattribute zusammengefasst, die über die API festgelegt werden können.

Name	Beschreibung	Standard	Erforderlich?
name	Attributnamen Auf MINT_DEVELOPER_CATEGORY festlegen.	–	Ja
value	ID der Entwicklerkategorie, der der Entwickler hinzugefügt wird.	–	Ja, um die Entwicklerkategorie festzulegen.