dotnet-api

dotnet-api

概要

ASP.NET Core API、データアクセス、バックエンドサービス、セキュリティ、クラウドネイティブのパターンを扱います。この統合スキルは、32 のトピック領域にわたります。以下のルーティングテーブルに基づき、references/ から適切なコンパニオンファイルを読み込んでください。

基本の依存ファイル：references/minimal-apis.md では、ほとんどの API 開発タスクに適用される ASP.NET Core Minimal API のコアパターン（ルートグループ、エンドポイントフィルター、TypedResults、パラメーターバインド）を定義しています。HTTP エンドポイントを構築する際は、デフォルトで読み込んでください。

最も広く共有されるコンパニオンファイル：references/architecture-patterns.md では、ほぼすべての ASP.NET Core プロジェクトで使われる垂直スライス、リクエストパイプライン、エラー処理、キャッシュ、冪等性のパターンを扱います。

ルーティングテーブル

トピック	キーワード	説明	関連ファイル
Minimal API	endpoint、route group、filter、TypedResults	Minimal API のルートグループ、フィルター、TypedResults、OpenAPI	references/minimal-apis.md
ミドルウェア	パイプラインの順序、短絡、例外	パイプラインの順序、短絡、例外処理	references/middleware-patterns.md
EF Core のパターン	DbContext、migrations、AsNoTracking	DbContext、AsNoTracking、クエリ分割、migrations	references/efcore-patterns.md
EF Core のアーキテクチャ	読み取り／書き込みの分離、集約の境界、N+1	読み取り／書き込みの分離、集約の境界、N+1	references/efcore-architecture.md
データアクセス戦略	EF Core、Dapper、ADO.NET の選択	EF Core、Dapper、ADO.NET の選択マトリックス	references/data-access-strategy.md
gRPC	proto、コード生成、ストリーミング、認証	Proto 定義、コード生成、ASP.NET Core ホスト、ストリーミング	references/grpc.md
リアルタイム通信	SignalR、SSE、JSON-RPC、gRPC ストリーミング	SignalR ハブ、SSE、JSON-RPC 2.0、スケーリング	references/realtime-communication.md
回復性	Polly v8、再試行、サーキットブレーカー、タイムアウト	Polly v8 の再試行、サーキットブレーカー、タイムアウト、レートリミッター	references/resilience.md
HTTP クライアント	IHttpClientFactory、型指定／名前付き、DelegatingHandler	IHttpClientFactory、型指定／名前付きクライアント、DelegatingHandler	references/http-client.md
API バージョン管理	Asp.Versioning、URL／ヘッダー／クエリ、提供終了	Asp.Versioning.Http/Mvc、URL／ヘッダー／クエリ、提供終了	references/api-versioning.md
OpenAPI	MS.AspNetCore.OpenApi、Swashbuckle、NSwag	MS.AspNetCore.OpenApi、Swashbuckle からの移行、NSwag	references/openapi.md
API セキュリティ	Identity、OAuth/OIDC、JWT、CORS、レート制限	Identity、OAuth/OIDC、JWT ベアラー、CORS、レート制限	references/api-security.md
OWASP	インジェクション、認証、XSS、非推奨 API	.NET 向け OWASP Top 10 のセキュリティ強化	references/security-owasp.md
シークレット	user secrets、環境変数、ローテーション	User secrets、環境変数、ローテーション	references/secrets-management.md
暗号技術	AES-GCM、RSA、ECDSA、ハッシュ化、鍵導出	AES-GCM、RSA、ECDSA、ハッシュ化、PQC 鍵導出	references/cryptography.md
バックグラウンドサービス	BackgroundService、IHostedService、ライフサイクル	BackgroundService、IHostedService、ライフサイクル	references/background-services.md
Aspire	AppHost、サービス検出、ダッシュボード	AppHost、サービス検出、コンポーネント、ダッシュボード	references/aspire-patterns.md
Semantic Kernel	AI/LLM プラグイン、プロンプト、メモリ、エージェント	AI/LLM プラグイン、プロンプトテンプレート、メモリ、エージェント	references/semantic-kernel.md
アーキテクチャ	垂直スライス、レイヤー、パイプライン、キャッシュ	垂直スライス、レイヤー、パイプライン、キャッシュ	references/architecture-patterns.md
メッセージング	Wolverine、Azure Service Bus、RabbitMQ、pub/sub、サーガ	Wolverine、Azure Service Bus、RabbitMQ、pub/sub、サーガ	references/messaging-patterns.md
サービス間通信	REST、gRPC、SignalR の選択マトリックス	REST、gRPC、SignalR の選択マトリックス	references/service-communication.md
API サーフェスの検証	PublicApiAnalyzers、Verify、ApiCompat	PublicApiAnalyzers、Verify スナップショット、ApiCompat	references/api-surface-validation.md
ライブラリ API の互換性	バイナリ／ソース互換性、型フォワーダー	バイナリ／ソース互換性、型フォワーダー、SemVer	references/library-api-compat.md
I/O パイプライン	PipeReader/PipeWriter、バックプレッシャー、Kestrel	PipeReader/PipeWriter、バックプレッシャー、Kestrel	references/io-pipelines.md
エージェントの注意点	async の誤用、NuGet エラー、DI の誤り	.NET コードでよくあるエージェントのミス	references/agent-gotchas.md
ファイルベースアプリ	.NET 10、ディレクティブ、csproj の移行	.NET 10 のファイルベース C# アプリ	references/file-based-apps.md
API ドキュメント	DocFX、ドキュメントとしての OpenAPI、バージョン管理されたドキュメント	DocFX、ドキュメントとしての OpenAPI、バージョン管理されたドキュメント	references/api-docs.md
HybridCache	HybridCache、L1/L2、スタンピード、タグによる削除	HybridCache（.NET 9 以降）、スタンピード保護、タグベースの削除	references/hybrid-cache.md
YARP	リバースプロキシ、ロードバランシング、API ゲートウェイ、BFF	YARP リバースプロキシ、ロードバランシング、ヘルスチェック、変換	references/yarp.md
出力キャッシュ	OutputCache、レスポンスキャッシュ、圧縮	出力／レスポンスキャッシュ、圧縮、CDN、タグによる無効化	references/output-caching.md
Identity	ASP.NET Core Identity、ログイン、MFA、スキャフォールディング	Identity のセットアップ、スキャフォールディング、外部プロバイダー、MapIdentityApi	references/identity-setup.md
Office ドキュメントと PDF	Excel、Word、PowerPoint、PDF、Open XML SDK、スプレッドシート、docx、xlsx、PDFsharp、MigraDoc、PDF の結合、PDF の分割、透かし	Open XML SDK、ClosedXML、PDF の作成／読み取り／結合／分割／透かしに対応する PDFsharp/MigraDoc	references/office-documents.md

対象範囲

• ASP.NET Core Web API（最小構成とコントローラー方式）
• データアクセス（EF Core、Dapper、ADO.NET）
• サービス間通信（gRPC、SignalR、SSE、メッセージング）
• セキュリティ（認証、OWASP、シークレット、暗号化）
• クラウドネイティブ（Aspire、レジリエンス、バックグラウンドサービス）
• AI 統合（Semantic Kernel）
• アーキテクチャパターンと API サーフェスの検証

対象範囲外

• C# 言語機能 → dotnet-csharp
• UI のレンダリング → dotnet-ui
• テストの作成 → dotnet-testing
• CI/CD パイプライン → dotnet-devops
• ビルドツール → dotnet-tooling