Kurz: Volání rozhraní API a zobrazení výsledků

Článek
01/19/2024

V předchozím kurzu jste do aplikace přidali prostředí pro přihlášení a odhlášení. Teď je možné aplikaci nakonfigurovat tak, aby volala webové rozhraní API. Pro účely tohoto kurzu se volá rozhraní Microsoft Graph API k zobrazení informací o profilu přihlášeného uživatele.

V tomto kurzu:

Volání rozhraní API a zobrazení výsledků
Testování aplikace

Požadavky

Dokončení požadavků a kroků v kurzu: Přidání přihlášení do aplikace

Volání rozhraní API a zobrazení výsledků

V části Stránky otevřete soubor Index.cshtml.cs a nahraďte celý obsah souboru následujícím fragmentem kódu. Zkontrolujte, jestli projekt namespace odpovídá názvu projektu.

using System.Text.Json;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.Identity.Web;
using Microsoft.Identity.Abstractions;

namespace sign_in_webapp.Pages;

[AuthorizeForScopes(ScopeKeySection = "DownstreamApi:Scopes")]
public class IndexModel : PageModel
{
    private readonly ILogger<IndexModel> _logger;

    private readonly IDownstreamApi  _downstreamWebApi;

    public IndexModel(ILogger<IndexModel> logger,
                        IDownstreamApi  downstreamWebApi)
    {
        _logger = logger;
        _downstreamWebApi = downstreamWebApi;
    }

    public async Task OnGet()
    {
        using var response = await _downstreamWebApi.CallApiForUserAsync("DownstreamApi").ConfigureAwait(false);
        if (response.StatusCode == System.Net.HttpStatusCode.OK)
        {
            var apiResult = await response.Content.ReadFromJsonAsync<JsonDocument>().ConfigureAwait(false);
            ViewData["ApiResult"] = JsonSerializer.Serialize(apiResult, new JsonSerializerOptions { WriteIndented = true });
        }
        else
        {
            var error = await response.Content.ReadAsStringAsync().ConfigureAwait(false);
            throw new HttpRequestException($"Invalid status code in the HttpResponseMessage: {response.StatusCode}: {error}");
        }
    }
}

Otevřete Soubor Index.cshtml a do dolní části souboru přidejte následující kód. Tento postup zpracovává, jak se zobrazují informace přijaté z rozhraní API:

<p>Before rendering the page, the Page Model was able to make a call to Microsoft Graph's <code>/me</code> API for your user and received the following:</p>

<p><pre><code class="language-js">@ViewData["ApiResult"]</code></pre></p>

<p>Refreshing this page will continue to use the cached access token acquired for Microsoft Graph, which is valid for future page views will attempt to refresh this token as it nears its expiration.</p>

Testování aplikace

Spusťte aplikaci tak , že vyberete Start bez ladění.

V závislosti na integrovaném vývojovém prostředí budete možná muset zadat identifikátor URI aplikace do prohlížeče, například https://localhost:7100. Po zobrazení přihlašovacího okna vyberte účet, pomocí kterého se chcete přihlásit. Ujistěte se, že účet odpovídá kritériím registrace aplikace.
Po výběru účtu se zobrazí druhé okno s oznámením, že se na vaši e-mailovou adresu odešle kód. Vyberte Odeslat kód a zkontrolujte doručenou poštu e-mailu.
Otevřete e-mail od týmu účtu Microsoft odesílatele a zadejte 7místný kód pro jedno použití. Po zadání vyberte Přihlásit se.
U možnosti Zůstat přihlášeni můžete vybrat možnost Ne nebo Ano.
Aplikace požaduje oprávnění k údržbě přístupu k datům, ke kterým jste jim udělili přístup, a k přihlášení a čtení profilu. Zvolte Přijmout.
Zobrazí se následující snímek obrazovky, který označuje, že jste se přihlásili k aplikaci a že jste z rozhraní Microsoft Graph API přistupovali k podrobnostem profilu.

Odhlaste se z aplikace

Vyhledejte odkaz Odhlásit se v pravém horním rohu stránky a vyberte ho.
Zobrazí se výzva k výběru účtu, ze kterém se chcete odhlásit. Vyberte účet, který jste použili k přihlášení.
Zobrazí se zpráva s oznámením, že jste se odhlásili. Teď můžete okno prohlížeče zavřít.

Další kroky

Naučte se používat platformu Microsoft Identity Platform vytvořením webového rozhraní API v následující sérii kurzů.

Kurz: Registrace webového rozhraní API na platformě Microsoft Identity Platform

Sdílet prostřednictvím