Entwicklerkategorien verwalten

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen info

Eine Entwicklerkategorie ist eine Gruppierung 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 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 Tarifplänen mit Entwicklerkategorien finden Sie unter Tarifpläne erstellen.

Die Seite „Entwicklerkategorien“ ansehen

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 für die neue Kategorie und eine kurze Beschreibung 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

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

Entwicklerkategorie über die 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, müssen Sie sowohl die Kategorie name als auch description in der Nutzlast 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

Sie können einer Entwicklerkategorie einen Entwickler oder ein Unternehmen hinzufügen, wenn 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 des Unternehmens oder Entwicklers einer Entwicklerkategorie einen Entwickler oder ein Unternehmen 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. Im folgenden Beispiel wird 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}, wobei {category_id} die ID 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

Alle API-Entwicklerkategorien für eine Organisation ansehen, 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, wobei {category_id} die ID der zu aktualisierenden Kategorie ist. Im Anfragetext müssen Sie 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

Wenn Sie eine Entwicklerkategorie löschen möchten, senden Sie eine DELETE-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}, wobei {category_id} die ID 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 für Entwicklerkategorien für die API

In der folgenden Tabelle sind die Konfigurationsattribute zusammengefasst, die mit der API festgelegt werden können.