Mi az a Dev Proxy?

A Dev Proxy egy API-szimulátor, amely segít könnyedén tesztelni az alkalmazást a boldog útvonalon túl.

Tesztelje az alkalmazást, hogy biztosan a kívánt módon működjön. De mi a teendő, ha a használt API-k sikertelenek? Az alkalmazás elveszíti az ügyfél adatait? Hogyan teszteli ezt? Az API-hibák szimulálása nehéz. A végén olyan kódot ír, amelyet nem fog szállítani, vagy ami még rosszabb: egyáltalán nem teszteli. Ezért hoztuk létre a Dev Proxyt az API-hibák szimulálásához, hogy egyszerűen tesztelhesse az alkalmazást a kód módosítása nélkül.

Ön a Dev Proxy segítségével:

• Megtudhatja, hogyan reagál az alkalmazás az API-hibákra az alkalmazás kódjának módosítása nélkül, így robusztusabb alkalmazásokat hozhat létre, és nem veszítheti el az ügyfelek adatait.
• Ellenőrizze, hogy az alkalmazás hogyan kezeli az API-sebességkorlátokat, így elkerülheti a szabályozást, és javíthatja az ügyfelek felhasználói élményét.
• Megtudhatja, hogyan kezeli az alkalmazás a lassú API-kat, hogy megvalósíthassa a szükséges megfizethetőségeket, és felhasználóbarátabbá tegye az alkalmazást.
• A stand-up api-kat gyorsan modellezheti kódsor írása nélkül, így az alkalmazás létrehozására összpontosíthat ahelyett, hogy olyan kódot ír, amelyet nem fog szállítani.
• Az API-k használatának kontextusalapú útmutatásával javíthatja az alkalmazást, hogy még jobb legyen az alkalmazás.

A Dev Proxy egy parancssori eszköz, amely bármilyen platformon működik. Mivel elfogja a hálózati kéréseket, bármilyen típusú alkalmazással és technológiai háttérrel működik. A Dev Proxy nyílt forráskód és szabadon használható.

Kinek szól a Dev Proxy?

A fejlesztői proxy a következő fejlesztőknek nyújt segítséget:

• API-kat hívó alkalmazások létrehozása – Annak tesztelése, hogy az alkalmazás hogyan kezeli az API-k (például GitHub, OpenAI és Anthropic) hibáit és sebességkorlátjait a kód módosítása nélkül
• Alkalmazások létrehozása a Microsoft Graph használatával – Útmutató az engedélyekhez és az ajánlott eljárásokhoz
• Tervezési API-k – Api-k prototípusa és makettje a megvalósítás előtt
• Tesztelés automatizálása – Káosztesztelés integrálása CI/CD-folyamatokba

Mikor érdemes fejlesztői proxyt használni?

A Dev Proxy használata a következő esetekben szükséges:

• Az API rugalmasságának tesztelése az alkalmazáskód módosítása nélkül
• Bármilyen technológiai stack használata (böngésző, Node.js, .NET, Python stb.)
• Nem szabályozható API-k hibáinak szimulálása
• Útmutató a Microsoft Graph ajánlott eljárásaihoz
• Káosztesztelés automatizálása CI/CD-folyamatokban

Fontolja meg az egyéb megközelítéseket, ha:

• Csak a felhasználói felület egységtesztjeinek böngészőn belüli szimulációjára van szükség.
• Az API-t éppen készíti, és szerződéses tesztelésre van szüksége.
• Programozott módon kell módosítania a kérés-/választesteket (a dev proxy ezt megteheti, de a dedikált eszközök egyszerűbbek lehetnek)

Gyors üzembe helyezés forgatókönyv szerint

Válassza ki az elérési utat az elérni kívánt cél alapján:

Mit kíván tenni?	Idő	Guide
Az alkalmazásom tesztelése API-hibákat kezel	5 perc	Tesztelés véletlenszerű hibákkal
Teszteld, hogy az alkalmazásom kezeli a GitHub API sebességkorlátait	15 perc	Az API-sebességkorlátok tesztelése GitHub
Teszteld, hogy az alkalmazásom kezeli az OpenAI sebességkorlátait	10 perc	OpenAI-sebességkorlátok tesztelése
A még nem létező API-k ki makettje	10 perc	CRUD API szimulálása
Microsoft Graph-engedélyek ellenőrzése	10 perc	Minimális engedélyek észlelése
Az alkalmazás által indított API-k megismerése	5 perc	Megtekintésre használt URL-címek felderítése
API-tesztelés automatizálása CI/CD-ben	15 perc	Dev Proxy használata CI/CD-ben

API-probléma megoldása

API-hibát kapott, vagy MI-alkalmazást vagy ügynököt épít? Induljon ki a problémából:

• Hibák és korlátok:429 Túl sok kérés, Retry-After, 500, 502, 503 és 504 hiba, GitHub API-sebességkorlát túllépve, OpenAI rate limit reached, Anthropic 529 overloaded_error, .NET HttpClient-időtúllépések
• AI-alkalmazások és -ügynökök:LLM-sebességkorlátok, A kódolási ügynök által írt hiba kezelésének ellenőrzése, Az AI-ügynök által az eszközök meghibásodása esetén végzett művelet tesztelése, az AI-ügynök tesztelése promptinjektálás szempontjából az eszközök válaszaiban

Próbálja ki egy előbeállítással

Az előre beállított beállítások kész Dev Proxy-konfigurációk adott API-khoz. Annak megtekintéséhez, hogy az alkalmazás hogyan kezeli az általa hívott API sebességkorlátait és hibáit, először telepítse a Dev Proxyt.

winget install DevProxy.DevProxy --silent

A telepítés befejezése után nyisson meg egy új parancssort, hogy az a frissített PATH-t vegye fel.

brew tap dotnet/dev-proxy
brew install dev-proxy

bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"

Ezután töltse le az API-hoz tartozó előbeállítást.

API	Parancs
GitHub	devproxy config get github-rate-limiting
OpenAI	devproxy config get openai-throttling
Anthropic	devproxy config get anthropic-throttling
Microsoft Graph	devproxy config get microsoft-graph-rate-limiting

Indítsa el a Dev Proxyt az előbeállítással. Cserélje le github-rate-limiting elemet a letöltött előbeállításra. A Dev Proxy első indításakor meg kell bíznia a tanúsítványában.

devproxy --config-file "~dataFolder/configs/github-rate-limiting/.devproxy/devproxyrc.json"

Futtassa az alkalmazást a szokásos módon. Folyamatosan meghívja a valódi API-URL-címeket, és a Dev Proxy szimulálja az API rátakorlátait és hibáit.

Az egyéb API-k előbeállításaiért lásd a Dev Proxy mintagalériát.

Hogyan kezeli az alkalmazás az API-hibákat?

Első lépések

Lásd még

• Fejlesztői proxy beállítása – Telepítés és első futtatás
• Fejlesztői proxy konfigurálása – Testreszabás az igényeinek megfelelően
• Útmutatók – Feladatorientált útmutatók
• Műszaki referencia – Beépülő modul dokumentációja