Entwicklerkategorien verwalten

Sie sehen sich die Dokumentation zu Apigee Edge an.
Rufen Sie die Dokumentation zu Apigee X auf. Weitere Informationen

Eine Entwicklerkategorie ist eine Gruppe von Entwicklern oder Unternehmen mit ähnlichen Merkmalen, mit der du die Monetarisierung für diese bestimmte Kategorie konfigurieren kannst. Sie können beispielsweise Tarifpläne 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 über die Benutzeroberfläche eine Entwicklerkategorie 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üge 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 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 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

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

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, 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"
}

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

Um beim Bearbeiten des Unternehmens oder Entwicklers einen Entwickler oder ein Unternehmen einer Entwicklerkategorie hinzuzufügen, 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 das 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 ansehen

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

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. 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.

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.