API-Produktabos über die API erwerben und verwalten

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Wenn Sie Ihr eigenes benutzerdefiniertes Portal erstellen oder den Kaufprozess manuell verwalten möchten, wird in den folgenden Abschnitten beschrieben, wie Sie API-Produktabos mithilfe der API erwerben und verwalten können. Weitere Informationen finden Sie unter Integrieren Sie die Monetarisierung von Apigee in Ihr Drupal-Entwicklerportal.

API-Produktabos über die API erwerben

Senden Sie eine POST-Anfrage an die folgende API, um ein API-Produktabo zu kaufen: https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions

Konfigurieren Sie die API-Produktaboanfrage. Füllen Sie dazu die erforderlichen Felder im Anfragetext aus, wie unter Ressource: Abos beschrieben.

Mit dem folgenden API-Aufruf wird beispielsweise ein Abo des API-Produkts HelloworldProduct für den angegebenen Entwickler erworben: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{"apiproduct":"HelloworldProduct"}'

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen finden Sie unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe. startTime ist auf die aktuelle Zeit eingestellt.

{
   "name": "69f8bb42-a8e4-4a2c-b932-d82b51d37b72",
   "apiproduct": "HelloworldProduct",
   "startTime": "1615987132000",
   "createdAt": "1615903252000",
   "lastModifiedAt": "1615903252000"
}

Weitere Informationen finden Sie in der API-Produktabo kaufen.

API-Produktabo sofort ablaufen lassen

Wenn Sie ein API-Produktabo sofort erneuern möchten, senden Sie eine POST-Anfrage an die folgende API: https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions/$SUBSCRIPTION:expire

Mit dem folgenden API-Aufruf läuft beispielsweise das API-Produktabo mit dem Namen 69f8bb42-a8e4-4a2c-b932-d82b51d37b72 für den angegebenen Entwickler ab: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions/69f8bb42-a8e4-4a2c-b932-d82b51d37b72:expire" \
  -X POST \
  -H "Authorization: Bearer $TOKEN"

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen finden Sie unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe. endTime ist auf die aktuelle Zeit eingestellt.

{
  "name": "33f8dd42-c7x5-3s3f-b098-d=c93h22m36b47",
  "apiproduct": "WeatherReport",
  "startTime": "1613494852000",
  "endTime" : "1617894954000",
  "createdAt": "1613494852000",
  "lastModifiedAt": "1613494852000"
}

Alle API-Produktabos für einen Entwickler auflisten

Wenn Sie alle API-Produktabos für einen Entwickler auflisten möchten, senden Sie eine GET-Anfrage an die folgende API: https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions

Sie können die folgenden Felder übergeben, um die Paginierung zu unterstützen:

  • startKey, um den Namen des API-Produktabos anzugeben, ab dem die Liste der Abos angezeigt werden soll. Wird kein Wert angegeben, beginnt die Liste ab dem ersten Element. Verwenden Sie count, um das Filtern präziser zu gestalten. Wenn Sie beispielsweise die API-Produktabos von 51 bis 150 ansehen möchten, setzen Sie den Wert von startKey auf den Namen des 51. Abos und legen Sie den Wert von count auf 100 fest.
  • count, um die Anzahl der Tarifpläne anzugeben, die im API-Aufruf zurückgegeben werden sollen. Verwenden Sie startKey, um das Filtern präziser zu gestalten. Die Höchstzahl liegt bei 1.000. Die Standardeinstellung ist 100.

Der folgende API-Aufruf listet beispielsweise alle API-Produktabos für den angegebenen Entwickler auf: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
  "developerSubscriptions": [
    {
      "name": "69f8bb42-a8e4-4a2c-b932-d82b51d37b72",
      "apiproduct": "HelloworldProduct",
      "startTime": "1615987132000",
      "createdAt": "1615903252000",
      "lastModifiedAt": "1615903252000"
    },
    {
      "name": "33f8dd42-c7x5-3s3f-b098-d=c93h22m36b47",
      "apiproduct": "WeatherReport",
      "startTime": "1614124552000",
      "createdAt": "1613494852000",
      "lastModifiedAt": "1613494852000"
    }
  ]
}

Weitere Informationen finden Sie unter API-Produktabos auflisten.

Details zu einem API-Produktabo ansehen

Wenn Sie Details zu einem API-Produktabo für einen Entwickler ansehen möchten, senden Sie eine GET-Anfrage an die folgende API: https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions/$SUBSCRIPTION

Der folgende API-Aufruf listet beispielsweise alle API-Produktabos für den angegebenen Entwickler auf: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG/developers/$DEVELOPER_EMAIL/subscriptions/69f8bb42-a8e4-4a2c-b932-d82b51d37b72" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
   "name": "69f8bb42-a8e4-4a2c-b932-d82b51d37b72",
   "apiproduct": "HelloworldProduct",
   "startTime": "1615987132000",
   "createdAt": "1615903252000",
   "lastModifiedAt": "1615903252000"
}

Weitere Informationen finden Sie unter API-Produktabo abrufen.