gateway-facade

Wrap HttpClient calls for control panel REST APIs into typed gateway classes.

4|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/FaysilAlshareef/dotnet-ai-kit --skill gateway-facade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gateway-facade
Source: https://github.com/FaysilAlshareef/dotnet-ai-kit/tree/main/skills/microservice/controlpanel/gateway-facade
Command: npx skills add https://github.com/FaysilAlshareef/dotnet-ai-kit --skill gateway-facade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gateway Facade abstracts HttpClient usage for control panel APIs by providing typed gateway wrappers that centralize routing, error handling, and reuse of common patterns.

Core Features & Use Cases

  • Typed gateway wrappers around HttpClient for REST endpoints in the control panel domain.
  • Nested management classes organize endpoints by domain and enable lazy initialization.
  • HttpExtensions provide consistent serialization and error handling; uniform return type like ResponseResult<T>.
  • Registration in DI via AddGatewayClients to configure typed HttpClient instances.

Quick Start

Install and configure the gateway client, then start calling gateway methods to interact with the control panel API.

Frequently Asked Questions about gateway-facade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I wrap HttpClient calls with typed gateway classes for microservice control panels?

You wrap HttpClient calls with typed gateway classes by using HttpExtensions for consistent serialization and error handling, organizing endpoints into nested management classes, and returning a uniform ResponseResult<T> type. This centralizes routing and reuse for control panel REST APIs.

What is the best way to centralize error handling for REST API calls in a microservice architecture?

Centralizing error handling for REST API calls is achieved by implementing a gateway facade pattern that enforces HttpExtensions and returns a uniform ResponseResult<T> type. This provides consistent error handling across all microservice control panel endpoints.

How do I register typed HttpClient instances in dependency injection for gateway facades?

You register typed HttpClient instances in dependency injection by using the AddGatewayClients configuration method. This sets up the DI container to provide configured, typed HttpClient instances to your gateway classes.

Can I organize control panel API endpoints by domain using nested management classes?

Yes, you can organize control panel API endpoints by domain using nested management classes. These classes group related endpoints together and enable lazy initialization, keeping your gateway facades structured and maintainable.

When do I need a typed gateway facade for my HttpClient implementation?

You need a typed gateway facade for your HttpClient implementation when working with microservice control panel scenarios that require consistent error handling, nested domain management, and dependency injection registration. It abstracts raw HttpClient usage into a reusable pattern.