Schritt 4: API testen

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Zum Testen der bereitgestellten helloworld API klicken Sie in Apigee in Cloud Code auf den Tab Terminal und geben den folgenden curl-Aufruf ein:

curl 0:8998/helloworld

Hinweis: In den Beispielen in diesem Abschnitt wird 0 als Hostwert und 8998 für den Portwert verwendet. Sie können die Portwerte konfigurieren, wie unter Apigee-Emulator verwalten beschrieben. Wenn Sie bei der Verwendung von 0 einen Fehler erhalten, ersetzen Sie localhost durch 0:

curl localhost:8998/helloworld

Die folgende Fehlermeldung wird angezeigt:

Aufrufen der API im Terminal-Tab und Abrufen eines Autorisierungsfehlers

Da Sie beim Erstellen des API-Proxys die API-Schlüsselauthentifizierung aktiviert haben, müssen Sie beim Aufruf der API einen API-Schlüssel mit dem Suchparameter apikey übergeben.

Um einen API-Schlüssel zu erhalten, müssen Sie ein Test-Bundle erstellen und die folgenden Testressourcen konfigurieren:

API-Produkt, mit dem die API gebündelt und für Entwickler verfügbar gemacht wird
Entwickler, der eine App für den Zugriff auf die API erstellt
Entwickler-App, die über einen API-Schlüssel den Zugriff auf die API ermöglicht

Erstellen und exportieren Sie Testressourcen, rufen Sie den API-Schlüssel ab und testen Sie die API noch einmal.

Erstellen Sie ein Test-Bundle:
1. Bewegen Sie den Mauszeiger im Apigee-Bereich über den Ordner tests und klicken Sie auf .
  
  Der Assistent zum Erstellen eines Test-Bundles wird geöffnet.
2. Geben Sie als Testnamen mytestbundle ein und drücken Sie die Eingabetaste.
  Das Test-Bundle wird erstellt.
3. Maximieren Sie im Apigee-Bereich den Ordner mytestbundle, um dessen Inhalt anzuzeigen.
API-Produkttestressource konfigurieren:
1. Bewegen Sie den Mauszeiger über die Datei products.json im Apigee-Bereich und klicken Sie auf .
  
  Der Assistent zum Erstellen einer API-Produkt wird geöffnet.
2. Geben Sie meinprodukt für den Namen des API-Produkts ein und drücken Sie die Eingabetaste, um den Vorgang zu bestätigen und fortzufahren.
3. Geben Sie myproduct ein, um die Beschreibung des API-Produkts einzugeben, und drücken Sie die Eingabetaste, um den Vorgang zu bestätigen und fortzufahren.
4. Wählen Sie helloworld aus, um den API-Proxy zum API-Produkt hinzuzufügen, und klicken Sie auf OK.
  Die Datei products.json wird im Editor geöffnet, während das neue API-Produkt konfiguriert ist:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "scopes": [],
    "environments": [],
    "apiResources": [
      "/",
      "/*",
      "/**"
    ],
    "quota": "100",
    "quotaInterval": "1",
    "quotaTimeUnit": "minute",
    "name": "myproduct",
    "displayName": "myproduct",
    "proxies": [
      "helloworld"
    ]
  }
]
```
Konfigurieren Sie die Entwickler-Testressource:
1. Bewegen Sie den Mauszeiger über die Datei developers.json im Apigee-Bereich und klicken Sie auf .
  
  Der Assistent zum Erstellen von Entwicklern wird geöffnet.
2. Geben Sie die folgenden Werte in die Eingabeaufforderung ein und drücken Sie zur Bestätigung die Eingabetaste:
  - E-Mail-Adresse des Entwicklers: ahamilton@example.com
  - Nutzername: ahamilton
  - Vorname: Alex
  - Nachname: Hamilton
  Die Datei developers.json wird im Editor mit dem neuen Entwickler geöffnet, wie im Folgenden gezeigt:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "email": "ahamilton@example.com",
    "userName": "ahamilton",
    "firstName": "Alex",
    "lastName": "Hamilton"
  }
]
```
Konfigurieren Sie die Testressource für die Entwickler-App:
1. Bewegen Sie den Mauszeiger über die Datei developerapps.json im Apigee-Bereich und klicken Sie auf .
  
  Der Assistent für Entwickler-App wird geöffnet.
2. Wählen Sie ahamilton@example.com als Inhaber der App aus.
3. Geben Sie beim nächsten Satz von Eingabeaufforderungen die folgenden Werte ein und bestätigen Sie mit den Eingabetaste:
  - App-Name: myapp
  - Beschreibung: myapp
  - Callback-URL: leer lassen
4. Wählen Sie myproduct aus, um das Produkt zur App hinzuzufügen, und klicken Sie auf OK.
5. Wählen Sie als Ablaufwert Nie aus.
  Die Datei developerapps.json wird im Editor mit der neuen Anwendung geöffnet:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "developerEmail": "ahamilton@example.com",
    "name": "myapp",
    "displayName": "myapp",
    "callbackUrl": "",
    "apiProducts": [
      "myproduct"
    ],
    "expiryType": "never"
  }
]
```
Exportieren Sie die Testressourcen in den Apigee Emulator.
Bewegen Sie den Mauszeiger im Apigee-Bereich auf das Test-Bundle mytestbundle und klicken Sie auf .

Hinweis: Wenn mehrere Container für den Apigee Emulator ausgeführt werden, werden Sie aufgefordert, den Container auszuwählen, in dem Sie die Umgebung bereitstellen möchten.

Die aktiven Testressourcen werden im Abschnitt "Apigee-Emulatoren" angezeigt, wie in der folgenden Abbildung dargestellt.
Klicken Sie im Bereich "Apigee-Emulator" unter "Aktive Testressourcen" auf Aktive Entwickler-Apps.
Die aktive Konfigurationsdatei für Entwickler-Apps wird im Editor geöffnet. Die Datei enthält Anmeldedaten für myproduct, wie in der folgenden Abbildung dargestellt.
Kopieren Sie den Wert consumerKey (ohne Anführungszeichen) für das API-Produkt myproduct.
Übergeben Sie den API-Schlüssel in Ihrem curl-Aufruf mit dem Suchparameter apikey so:
```
curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY
```
Die folgende Antwort wird zurückgegeben
```
Hello, Guest!
```

Das wars! Sie haben eine API in Ihrer lokalen Umgebung erfolgreich ausgeführt.

Im nächsten Schritt erfahren Sie, wie Sie den Zielendpunkt ändern können.

1 2 3 4 (NÄCHSTER) Schritt 5: Zielendpunkt ändern 6 7 8