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.
Edge-Benutzeroberfläche
So greifen Sie auf die Seite „Develop Categories“ zu:
- Melden Sie sich bei apigee.com/edge an.
- Wählen Sie in der linken Navigationsleiste Veröffentlichen > Monetarisierung > Entwicklerkategorien aus.
Die Seite „Entwicklerkategorien“ wird angezeigt.
Wie in der Abbildung hervorgehoben, können Sie auf der Seite „Entwicklerkategorien“ Folgendes tun:
- Aktuelle Entwicklerkategorien ansehen
- Entwicklerkategorie hinzufügen, bearbeiten oder löschen
Classic Edge (Private Cloud)
So greifen Sie über die Classic Edge-Benutzeroberfläche auf die Seite „Kategorien entwickeln“ zu:
- Melden Sie sich bei
http://ms-ip:9000
an, wobei ms-ip die IP-Adresse oder der DNS-Name des Knotens des Verwaltungsservers ist. - Wählen Sie in der oberen Navigationsleiste Veröffentlichen > Entwicklerkategorien aus.
Die Seite „Entwicklerkategorien“ wird angezeigt.
Auf der Seite „Entwicklerkategorien“ können Sie:
- Aktuelle Entwicklerkategorien ansehen
- Entwicklerkategorie hinzufügen, bearbeiten oder löschen
Entwicklerkategorie hinzufügen
So fügen Sie eine Entwicklerkategorie über die Benutzeroberfläche hinzu:
- Rufen Sie die Seite Develop Categories (Kategorien entwickeln) auf.
- Klicken Sie auf + Entwicklerkategorie.
- Geben Sie einen Namen und eine kurze Beschreibung für die neue Kategorie ein.
- 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:
- Wählen Sie in der oberen Navigationsleiste Veröffentlichen > Unternehmen aus.
- Wählen Sie das Unternehmen aus, das Sie der Entwicklerkategorie hinzufügen möchten.
- Klicken Sie auf der Unternehmensseite auf Bearbeiten.
- Wählen Sie die Entwicklerkategorie des Unternehmens aus.
- Klicken Sie auf Speichern.
Entwicklerkategorie bearbeiten
So bearbeiten Sie eine Entwicklerkategorie über die Benutzeroberfläche:
- Rufen Sie die Seite Develop Categories (Kategorien entwickeln) auf.
- Bewegen Sie den Mauszeiger auf die Entwicklerkategorie, die Sie bearbeiten möchten, und klicken Sie auf .
- Geben Sie die Entwicklerkategorie ein.
- Klicken Sie auf Entwicklerkategorie aktualisieren.
Entwicklerkategorie löschen
So löschen Sie eine Entwicklerkategorie über die Benutzeroberfläche:
- Rufen Sie die Seite Develop Categories (Kategorien entwickeln) auf.
- Bewegen Sie den Mauszeiger auf die Entwicklerkategorie, die Sie bearbeiten möchten.
- Klicken Sie auf .
- 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. |