Sdílet prostřednictvím

Import rozhraní OData API

PLATÍ PRO: Všechny úrovně služby API Management

Tento článek ukazuje, jak importovat službu kompatibilní s OData jako rozhraní API ve službě API Management.

V tomto článku získáte informace o těchto tématech:

  • Import popisu metadat OData pomocí webu Azure Portal
  • Správa schématu OData na portálu
  • Zabezpečení rozhraní OData API

Požadavky

  • Instance služby správy API. Pokud ho ještě nemáte, proveďte následující rychlý start: Vytvořte instanci služby Azure API Management.

  • Služba vystavená jako OData v2 nebo v4.

Přejít k instanci služby API Management

  1. Na portálu Azure vyhledejte a vyberte služby API Management:

    Snímek obrazovky zobrazící služby API Management ve výsledcích hledání

  2. Na stránce služby API Management vyberte instanci služby API Management:

    snímek obrazovky znázorňující instanci služby API Management na stránce služeb API Management

Import metadat OData

  1. V nabídce vlevo vyberte rozhraní API> a pak vyberte + Přidat rozhraní API.

  2. V části Vytvořit z definice vyberte OData:

    Snímek obrazovky vytváření rozhraní API z popisu OData na portálu.

  3. Zadejte nastavení rozhraní API. Později můžete nastavení aktualizovat tak, že přejdete na kartu Nastavení rozhraní API.

    1. Ve specifikaci OData zadejte adresu URL koncového bodu metadat OData. Tato hodnota je obvykle adresa URL kořenového adresáře služby, připojena pomocí /$metadata. Případně vyberte místní soubor XML OData, který chcete importovat.

    2. Zadejte další nastavení pro konfiguraci rozhraní API. Tato nastavení jsou vysvětlena v tutoriálu Import a publikování vašeho prvního rozhraní API.

  4. Vyberte Vytvořit.

    Rozhraní API se přidává do seznamu rozhraní API. Sady entit a funkce, které jsou zveřejněné v popisu metadat OData, se zobrazí na kartě Sady entit a funkce rozhraní API.

    Snímek obrazovky znázorňující sady a funkce entit OData

Aktualizace schématu OData

V portálu můžete přistupovat k editoru, abyste si mohli prohlédnout schéma OData vašeho rozhraní API. Pokud se rozhraní API změní, můžete schéma ve službě API Management aktualizovat také ze souboru nebo koncového bodu služby OData.

  1. Na portálu přejděte do vaší instance služby API Management.

  2. V nabídce vlevo vyberte rozhraní API a pak vyberte rozhraní API OData.

  3. Na kartě Sady entit a funkce vyberte tři tečky (...) vedle sady nebo funkce entity a pak vyberte Upravit.

    Snímek obrazovky znázorňující umístění příkazu Upravit

  4. Zkontrolujte schéma. Pokud ho chcete aktualizovat, vyberte Možnost Aktualizovat ze souboru nebo Aktualizovat schéma z koncového bodu.

    Snímek obrazovky s editorem schémat pro rozhraní API OData

Testování rozhraní API OData

  1. V nabídce vlevo vyberte rozhraní API a pak vyberte rozhraní API OData.

  2. Na kartě Sady entit a funkce vyberte tři tečky (...) vedle sady nebo funkce entity a pak vyberte Test.

    Snímek obrazovky znázorňující příkaz Test

  3. V testovací konzole zadejte parametry šablony, parametry dotazu a hlavičky testu a pak vyberte Test. Další informace o testování rozhraní API na portálu najdete v tématu Testování nového rozhraní API na portálu.

Zabezpečení rozhraní OData API

Zabezpečte své rozhraní API OData použitím stávajících zásad ověřování a autorizace azásad ověřování OData pro ochranu před útoky prostřednictvím požadavků rozhraní OData API.

Návod

Na portálu nakonfigurujte zásady pro vaše rozhraní API OData na kartě Zásady rozhraní API.

Připojení dalších rozhraní API

Můžete vytvořit rozhraní API z rozhraní API, která jsou poskytovaná různými službami, včetně:

  • Specifikace OpenAPI
  • Rozhraní API SOAP
  • Rozhraní GraphQL
  • Webová aplikace hostovaná ve službě Azure App Service
  • Azure Functions
  • Azure Logic Apps
  • Azure Service Fabric

Poznámka:

Při importu rozhraní API se operace připojí k aktuálnímu rozhraní API.

Připojení API k existujícímu API:

  1. Na webu Azure Portal přejděte do své instance služby Azure API Management:

    snímek obrazovky se stránkou služby API Management

  2. Na stránce přehledu vyberte rozhraní API nebo v nabídce vlevo vyberte rozhraní API>.

    Snímek obrazovky znázorňující výběr rozhraní API na stránce Přehled

  3. Vyberte ikonu se třemi tečkami (...) vedle rozhraní API, k němuž chcete přidat další rozhraní API.

  4. V rozevírací nabídce vyberte Importovat:

    Snímek obrazovky s příkazem Importovat

  5. Vyberte službu, ze které se má importovat rozhraní API.

Související obsah

  • Last updated on