Senden von Anforderungen an die Graph-API

Abgeschlossen

Nachdem Sie Ihre App registriert und Authentifizierungstoken für einen Benutzer oder einen Dienst abgerufen haben, können Sie Anforderungen an die Microsoft Graph-API tätigen. In dieser Lerneinheit erfahren Sie mehr über Graph-Anforderungen und wie Sie das Graph SDK verwenden, um Anforderungen von Ihrer Teams-App zu senden.

Die Anatomie einer Graph-Anforderung

Erstellen Sie eine Anforderung, die der folgenden ähnlich ist, um in eine Ressource zu schreiben bzw. daraus zu lesen. Ressourcen können z. B. Benutzer oder E-Mail-Nachrichten sein.

{HTTP method} https://graph.microsoft.com/{version}/{resource}?{query-parameters}

Die Komponenten einer Anforderung umfassen Folgendes:

• {HTTP-Methode} – Die HTTP-Methode, die in der Anforderung an Microsoft Graph verwendet wird.
• {version} – Die Version der Microsoft Graph-API, die Ihre Anwendung verwendet.
• {resource} – Die Ressource in Microsoft Graph, auf die Sie verweisen.
• {query-parameters} – Optionale OData-Abfrageoptionen oder REST-Methodenparameter zur Anpassung der Antwort.
• {headers} – Anforderungsheader, die die Anforderung anpassen. Kann je nach API optional oder erforderlich sein.

Nachdem Sie eine Anforderung vorgenommen haben, wird eine Antwort zurückgegeben, die Folgendes umfasst:

• Statuscode: Ein HTTP-status Code, der auf Erfolg oder Fehler hinweist. Informationen zu HTTP-Fehlercodes finden Sie unter Fehler.
• Antwortnachricht : Die angeforderten Daten oder das Ergebnis des Vorgangs. Die Antwortnachricht kann für einige Vorgänge leer sein.
• @odata.nextLink : Wenn Ihre Anforderung viele Daten zurückgibt, müssen Sie sie mithilfe der in @odata.nextLinkzurückgegebenen URL durchlaufen. Weitere Informationen finden Sie unter Auslagern.
• Antwortheader : Zusätzliche Informationen zur Antwort, z. B. den Typ des zurückgegebenen Inhalts und die Anforderungs-ID, die Sie verwenden können, um die Antwort mit der Anforderung zu korrelieren.

Experimentieren mit Graph Explorer

Graph Explorer ist ein webbasiertes Tool, mit dem Sie Anforderungen mithilfe von Microsoft Graph-APIs erstellen und testen können. Dies ist ein hervorragendes Tool, um mit Anforderungen zu experimentieren, bevor sie in Ihrer Codelösung implementiert werden.

Wenn Sie sich nicht anmelden, werden Ihre Anforderungen mithilfe von Beispieldaten ausgeführt, oder Sie können sich bei einem eigenen Mandanten anmelden, um Anforderungen für Livedaten auszuführen.

Führen Sie die folgenden Schritte aus, um die Anforderung in Graph Explorer zu erstellen:

1. Wählen Sie die HTTP-Methode aus.
2. Wählen Sie die Version der API aus, die Sie verwenden möchten.
3. Geben Sie die Abfrage in das Anforderungstextfeld ein.
4. Wählen Sie Abfrage ausführen aus.

Das folgende Beispiel zeigt eine Abfrage, die Informationen zu Benutzern im Demomandanten zurückmeldet:

Sie können Postman auch mit dem Graph-API verwenden.

Senden von Anforderungen mithilfe des SDK

Die Microsoft Graph SDKs wurden entwickelt, um das Erstellen von qualitativ hochwertigen, effizienten und resilienten Anwendungen zu vereinfachen, die auf Microsoft Graph zugreifen. Die Microsoft Graph SDK-Dienstbibliotheken stellen eine Clientklasse bereit, die als Ausgangspunkt für die Erstellung aller API-Anforderungen verwendet werden kann.

Der Microsoft Graph-Client dient dazu, Aufrufe von Microsoft Graph einfacher zu gestalten. Sie können eine einzelne Client-Instanz für die gesamte Lebensdauer der Anwendung verwenden.

Sobald Sie die Authentifizierung eingerichtet und eine instance Client eingerichtet haben, können Sie damit beginnen, Aufrufe an den Dienst zu senden. Alle Anforderungen sollten mit client.api(path) einer Aktion beginnen und mit einer Aktion enden, z .get() . B. oder .put().

Hier sehen Sie ein Beispiel für das Anfordern von Benutzerdetails mithilfe der get() Aktion:

try {
	let userDetails = await client.api("/me").get();
	console.log(userDetails);
} catch (error) {
	throw error;
}