Entwicklerkategorien verwalten

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. 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 Tarifpakete 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 Tarifpaketen mit Entwicklerkategorien finden Sie unter Tarifpakete erstellen.

Seite „Entwicklerkategorien“

Sie können über die Edge-Benutzeroberfläche oder die Classic Edge-Benutzeroberfläche auf die Seite „Entwicklerkategorien“ zugreifen, 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 „Entwicklerkategorien“ 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 zu einer Entwicklerkategorie hinzufügen

Fügen Sie einer Entwicklerkategorie ein Unternehmen hinzu. Ein Unternehmen kann nur zu einer Entwicklerkategorie gehö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 über die Benutzeroberfläche eine Entwicklerkategorie:

1. Rufen Sie die Seite „Entwicklerkategorien“ 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 über die Benutzeroberfläche eine Entwicklerkategorie:

1. Rufen Sie die Seite „Entwicklerkategorien“ 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 verwalten, 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, 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 mit der API zu einer Entwicklerkategorie hinzufügen

Wenn Sie ein Unternehmen oder einen Entwickler hinzufügen oder bearbeiten, können Sie es bzw. ihn einer Entwicklerkategorie hinzufügen, indem Sie eine POST -Anfrage an die folgenden Ressourcen senden:

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

Wenn Sie ein Unternehmen oder einen Entwickler bearbeiten und es bzw. ihn einer 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 ein Entwickler kann nur zu einer Entwicklerkategorie gehören.

Geben Sie MINT_DEVELOPER_CATEGORY als Attribut im Anfragetext an. Der Wert ist die interne ID der Kategorie. Mit 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 eine bestimmte Entwicklerkategorie oder alle Entwicklerkategorien in einer Organisation ansehen.

Senden Sie eine GET-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}, um eine bestimmte Entwicklerkategorie anzusehen. Dabei ist {category_id} die ID 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

Senden Sie eine GET-Anfrage an /mint/organizations/{org_id}/developer-categories, um alle API-Entwicklerkategorien für eine Organisation anzusehen. 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

Senden Sie eine PUT-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}, um eine Entwicklerkategorie zu bearbeiten. Dabei ist {category_id} die ID der Kategorie, die aktualisiert werden soll. Sie müssen im Anfragetext die aktualisierten Einstellungen und die ID der Entwickler Kategorie 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

Senden Sie eine DELETE-Anfrage an /mint/organizations/{org_name}/developer-categories/{category_id}, um eine Entwicklerkategorie zu löschen. Dabei ist {category_id} die ID der Entwicklerkategorie, die gelöscht werden soll. 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

Konfigurationsattribute für Entwicklerkategorien für die API

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