INTEGRITY Dokumentace

API Routing

API Shield Routing umožňuje vystavit jedno externí API, které směruje požadavky na různé backendové služby, i když tyto služby používají jiné cesty nebo hostitelské názvy než vaše zóna.

Proces

Source Endpoints musíte do Endpoint Management přidat zavedenými metodami, mezi které patří nahrávání schématu, přes API Discovery, nebo pomocí ruční přidání, než vytvoříte trasu.

Chcete-li vytvořit trasu, budete potřebovat operation ID daného Source Endpoint. Jak najít operation ID v dashboardu:

  1. V dashboardu Cloudflare přejděte na Webová aktiva stránce.

    Přejděte na Webová aktiva ↗
  2. Filtrujte endpointy a najděte svůj Source Endpoint.

  3. Rozbalte řádek pro váš Source Endpoint a poznamenejte si ID operace .

  4. Kliknutím na ikonu kopírování zkopírujte ID operace do schránky.

Jakmile jsou vaše Source Endpoints přidány do Endpoint Management, pomocí následujících kroků vytvořte a ověřte trasy pro libovolné ID operace:

Vytvoření trasy

  1. V dashboardu Cloudflare přejděte na Webová aktiva stránce.

    Přejděte na Webová aktiva ↗
  2. V Endpointy, vyberte existující koncový bod a rozbalte jeho podrobnosti.

  3. V části Směrování, vyberte Vytvořit trasu.

  4. Zadejte cílovou adresu URL nebo IP adresu, na kterou se má endpoint směrovat.

  5. Vyberte Nasadit trasu.

Trasu můžete upravit nebo odstranit také výběrem Úprava trasy na existující trase.

Otestovat trasu

Po odeslání požadavku na váš Source Endpoint byste měli vidět obsah backendové služby, jako byste volali přímo Target Endpoint.

Pokud API Shield vrací neočekávané výsledky, zkontrolujte hostitele, metodu a cestu u Source Endpoint a ověřit Route , abyste zajistili, že hodnota Target Endpoint je správná.

Dostupnost

API Shield Routing je momentálně v otevřené beta verzi a je dostupné pouze pro zákazníky s plánem Enterprise, kteří mají předplacené API Shield. Zákazníci s plánem Enterprise, kteří si API Shield nezakoupili, si mohou prohlédnout API Shield jako služba bez smlouvy ↗ v Cloudflare dashboardu nebo se obraťte na svůj tým podpory účtu.

Omezení

Target Endpoint nelze směrovat na Worker, pokud trasa vede do stejné zóny.

Metodu požadavku nemůžete změnit. Například GET Source Endpoint vždy odešle GET požadavek na Target Endpoint.

Musíte použít všechny proměnné z Target Endpoint, které se vyskytují v Source Endpoint. Například směrování /api/{var1}/users/{var2} na /api/users/{var2} není povoleno a způsobí chybu, protože {var1} je přítomný ve zdrojovém endpointu, ale ne v cílovém endpointu.