.NETヘルプ

OpenAPI .NET（開発者向けの動作方法）

更新日:6月 22, 2025

OpenAPI（以前はSwaggerとして知られていた）は、RESTful APIを構築および記述するための仕様です。開発者がAPIの構造を標準化された形式で定義することを可能にし、さまざまなツールやサービスがREST APIを効果的に理解して対話し、フィードバックを提供できるようにします。 .NETエコシステムでは、OpenAPI .NETの統合は、APIの作成、文書化、消費を容易にするためのいくつかのライブラリとツールによって容易にされます。

この記事では、OpenAPIのサポート仕様と、IronPDFを使用してPDFファイルを作成し、API呼び出しの応答として返す方法について学びます。

.NETでのOpenAPIの設定

OpenAPIの.NETプロジェクトを開始するには、通常Swashbuckleライブラリを使用します。これにより、ASP.NET CoreのAPIのためのOpenAPI仕様やドキュメントが生成されます。

ステップ1: Swashbuckleのインストール

まず、Visual StudioでNuGetを介してSwashbuckle.AspNetCoreパッケージをインストールする必要があります。これをNuGetパッケージマネージャーコンソールを使用して行うことができます:

Install-Package Swashbuckle.AspNetCore

または、.NET CLIを使用して行います:

dotnet add package Swashbuckle.AspNetCore

dotnet add package Swashbuckle.AspNetCore

SHELL

ステップ2: Swashbuckleの設定

次に、ASP.NET CoreプロジェクトでSwashbuckleを設定する必要があります。これは、Program.csファイルを更新してSwaggerサービスを追加し、Swaggerミドルウェアを設定することを含みます。

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddControllers();
// Configures Swagger/OpenAPI descriptions.
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddControllers();
// Configures Swagger/OpenAPI descriptions.
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
app.Run();

$vbLabelText $csharpLabel

APIドキュメントの生成と表示

Swashbuckleが設定されると、アプリケーションを実行することで、自動的にOpenAPIドキュメントが生成されます。これらのOpenAPI記述はSwagger UIインターフェースに移動することで表示できます。

OpenAPI定義の使用

OpenAPI定義は、クライアントSDKの生成、APIのテスト、および異なるサービス間の一貫性を保証するために使用できる強力なツールです。 OpenAPIの仕様は、サービスのソースコードにアクセスせずに、サービスの機能を人間やコンピューターが理解できるようにする標準の言語に依存しないインターフェースを定義します。

カスタム注釈によるOpenAPIの拡張

Swashbuckleは、カスタム注釈でOpenAPIドキュメントを強化することを可能にします。これらの注釈は、コントローラーやモデルに直接追加でき、APIの動作やデータ構造に関する追加情報を提供します。

例: カスタム注釈

using Microsoft.AspNetCore.Mvc;

namespace WebApplication8.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        private readonly ILogger<WeatherForecastController> _logger;

        public WeatherForecastController(ILogger<WeatherForecastController> logger)
        {
            _logger = logger;
        }

        [HttpGet(Name = "GetWeatherForecast")]
        [SwaggerOperation(Summary = "Gets the weather forecast for the next 5 days")]
        [SwaggerResponse(200, "Successfully retrieved weather forecast")]
        public IEnumerable<WeatherForecast> Get()
        {
            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateTime.Now.AddDays(index),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            })
            .ToArray();
        }
    }
}

using Microsoft.AspNetCore.Mvc;

namespace WebApplication8.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        private readonly ILogger<WeatherForecastController> _logger;

        public WeatherForecastController(ILogger<WeatherForecastController> logger)
        {
            _logger = logger;
        }

        [HttpGet(Name = "GetWeatherForecast")]
        [SwaggerOperation(Summary = "Gets the weather forecast for the next 5 days")]
        [SwaggerResponse(200, "Successfully retrieved weather forecast")]
        public IEnumerable<WeatherForecast> Get()
        {
            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateTime.Now.AddDays(index),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            })
            .ToArray();
        }
    }
}

$vbLabelText $csharpLabel

この例では、SwaggerOperationおよびSwaggerResponse属性を使用して、エンドポイントの詳細なOpenAPI記述や応答コードを提供しています。

出力

OpenAPI .NET（開発者向けの動作方法）: 図1 - カスタム注釈の出力

"実行"ボタンをクリックすると、次の応答を得ることができます。

OpenAPI .NET（開発者向けの動作方法）: 図2 - 応答出力

IronPDF

IronPDF for ASP.NETは、ASP.NETアプリケーション内でPDFドキュメントのシームレスな生成と操作を可能にする強力なツールです。その直感的なAPIと強力な機能を備えた開発者は、PDF生成をウェブプロジェクトに簡単に統合し、ユーザーに強化されたドキュメント管理機能を提供できます。 PDFを一から作成するか、HTMLコンテンツをPDFに変換するか、画像やテキストなどの動的要素を追加するか、いずれの場合もIronPDFはプロセスを簡素化し、効率的でプロフェッショナルなドキュメント生成を保証します。

NuGetパッケージマネージャーを使用してインストールする手順:

ASP.NETプロジェクトをVisual Studioで開き、"ツール"メニューに移動します。
"NuGetパッケージマネージャー"を選択し、"ソリューション用のNuGetパッケージを管理"をクリックします。
"参照"タブで"IronPDF"を検索し、希望のバージョンを選択します。 "インストール"をクリックして、プロジェクトにパッケージを追加します。 IronPDFとその依存関係は自動的にダウンロードおよび統合され、ASP.NETアプリケーションでその機能をシームレスに活用できるようになります。

OpenAPI .NET（開発者向けの動作方法）: 図3 - IronPDF

API呼び出しに対する応答としてPDFファイルを取得

次のコードをコントローラーファイルに追加してください。これはIronPDFを使用してPDFファイルを作成し、API呼び出しの応答として返します。

using Microsoft.AspNetCore.Mvc;
using IronPdf;

namespace WebApplication8.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        private readonly ILogger<WeatherForecastController> _logger;

        public WeatherForecastController(ILogger<WeatherForecastController> logger)
        {
            _logger = logger;
        }

        [HttpGet(Name = "GetWeatherForecast")]
        public IActionResult GetWeatherForecastPdf()
        {
            var htmlContent = @"
        <html>
        <head>
            <title>Weather Forecast</title>
        </head>
        <body>
            <h1>Weather Forecast</h1>
            <table>
                <tr>
                    <th>Date</th>
                    <th>Temperature (Celsius)</th>
                    <th>Summary</th>
                </tr>";

            var forecasts = Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateTime.Now.AddDays(index),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            });

            // Iterate over the forecasts and add data to the HTML string
            foreach (var forecast in forecasts)
            {
                htmlContent += $@"
            <tr>
                <td>{forecast.Date.ToShortDateString()}</td>
                <td>{forecast.TemperatureC}</td>
                <td>{forecast.Summary}</td>
            </tr>";
            }

            htmlContent += @"
            </table>
        </body>
        </html>";

            // Convert the HTML string to a PDF using IronPDF
            var renderer = new ChromePdfRenderer();
            var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

            // Retrieve the byte array of the generated PDF
            var pdfBytes = pdfDocument.BinaryData;
            // Return the PDF file to the client
            return File(pdfBytes, "application/pdf", "WeatherForecast.pdf");
        }
    }
}

using Microsoft.AspNetCore.Mvc;
using IronPdf;

namespace WebApplication8.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        private readonly ILogger<WeatherForecastController> _logger;

        public WeatherForecastController(ILogger<WeatherForecastController> logger)
        {
            _logger = logger;
        }

        [HttpGet(Name = "GetWeatherForecast")]
        public IActionResult GetWeatherForecastPdf()
        {
            var htmlContent = @"
        <html>
        <head>
            <title>Weather Forecast</title>
        </head>
        <body>
            <h1>Weather Forecast</h1>
            <table>
                <tr>
                    <th>Date</th>
                    <th>Temperature (Celsius)</th>
                    <th>Summary</th>
                </tr>";

            var forecasts = Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateTime.Now.AddDays(index),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            });

            // Iterate over the forecasts and add data to the HTML string
            foreach (var forecast in forecasts)
            {
                htmlContent += $@"
            <tr>
                <td>{forecast.Date.ToShortDateString()}</td>
                <td>{forecast.TemperatureC}</td>
                <td>{forecast.Summary}</td>
            </tr>";
            }

            htmlContent += @"
            </table>
        </body>
        </html>";

            // Convert the HTML string to a PDF using IronPDF
            var renderer = new ChromePdfRenderer();
            var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

            // Retrieve the byte array of the generated PDF
            var pdfBytes = pdfDocument.BinaryData;
            // Return the PDF file to the client
            return File(pdfBytes, "application/pdf", "WeatherForecast.pdf");
        }
    }
}

$vbLabelText $csharpLabel

OpenAPI .NET（開発者向けの動作方法）: 図4 - API出力

添付のPDFファイルをダウンロードして開きます。

OpenAPI .NET（開発者向けの動作方法）: 図5 - PDF出力

結論

OpenAPIは、以前はSwaggerとして知られており、Swashbuckleのようなライブラリを通じて.NETエコシステムでRESTful APIの設計とドキュメント化を簡素化し、ASP.NET Coreプロジェクトの自動APIドキュメント生成を促進します。 OpenAPIとIronPDFの相乗効果を示し、IronPDFの機能を活用してHTMLコンテンツからPDFファイルを生成し、API応答として返す方法を紹介し、ASP.NETアプリケーションの機能を強化しました。 OpenAPI標準を採用し、IronPDFの強力な機能を活用することで、開発者はAPIドキュメントのプラクティスを強化し、ユーザーに洗練された機能豊富なアプリケーションを提供できます。

IronPDFのライセンスに関する詳細情報は、IronPDFのライセンス詳細を参照してください。さらに、より詳しい指導については、HTMLからPDFへの変換チュートリアルを探索できます。

よくある質問

ASP.NETアプリケーションでHTMLコンテンツをPDFに変換するにはどうすればいいですか？

ASP.NETアプリケーションではIronPDFを使ってHTMLコンテンツをPDFに変換できます。IronPDFの機能を活用することで、HTML文字列やファイルをPDFドキュメントにレンダリングし、APIレスポンスとして提供したり、文書管理のために保存したりすることができます。

OpenAPIは.NETエコシステムにおいてどのような役割を果たしていますか？

OpenAPIは、RESTful APIの定義とドキュメント化を標準化された方法で提供することで、.NETエコシステムにおいて重要な役割を担っています。この統合は、多くの場合、Swashbuckleのようなツールを通じて行われ、OpenAPI仕様の生成を助け、ASP.NET Coreプロジェクト内でのAPIの容易な利用が可能になります。

.NETプロジェクトでSwashbuckleを使ってSwagger UIを設定するにはどうすればいいですか？

.NETプロジェクトでSwashbuckleを使ってSwagger UIを設定するには、NuGetを通じてSwashbuckle.AspNetCoreパッケージをインストールしてください。次に、Program.csファイルでSwaggerサービスを設定し、Swagger UIを通じてAPIドキュメントの自動生成とアクセスを可能にするSwaggerミドルウェアをセットアップします。

.NETでOpenAPI定義からクライアントSDKを生成するにはどうすればいいですか？

OpenAPI定義は、API呼び出しの複雑さを抽象化することで、APIの利用を容易にするクライアントSDKの生成に使用できます。.NETでは、Swashbuckleのようなツールがこれらの定義を生成し、その後AutoRestのようなツールと共に使用して、様々なプログラミング言語でクライアントSDKを作成します。

OpenAPIドキュメントでカスタムアノテーションを使用する利点は何ですか？

OpenAPIドキュメントのカスタムアノテーションは、API仕様の明確さと詳細を向上させます。.NETでは、Swashbuckleを使用して、SwaggerOperationやSwaggerResponseといった属性を使用し、説明やレスポンスコードを追加することで、APIドキュメントをより情報豊かで開発者にとって理解しやすくします。

ASP.NET CoreでPDFファイルをAPIレスポンスとして配信するにはどうすればいいですか？

ASP.NET CoreでPDFファイルをAPIレスポンスとして配信するには、IronPDFを使用します。IronPDFのレンダリングメソッドを使用してHTMLコンテンツからPDFを生成し、ASP.NET CoreのIActionResultを使用してPDFファイルをレスポンスの一部として出力します。

OpenAPIとPDF生成ツールの組み合わせがASP.NETアプリケーションにもたらす利点は何ですか？

OpenAPIとIronPDFのようなPDF生成ツールをASP.NETアプリケーションに組み合わせることで、包括的なAPIドキュメントが提供され、APIがプロフェッショナルなPDFドキュメントを返すことができます。この統合は、効率的な文書管理をサポートし、アプリケーションの総合的な機能を強化します。

Jacob Mellor

今すぐエンジニアリングチームとチャット

最高技術責任者（CTO）

Jacob Mellorは、Iron Softwareの最高技術責任者であり、C# PDF技術の開拓者としてその先進的な役割を担っています。Iron Softwareのコアコードベースのオリジナルデベロッパーである彼は、創業時から製品のアーキテクチャを形作り、CEOのCameron Rimingtonと協力してNASA、Tesla、全世界の政府機関を含む50人以上の会社に成長させました。

Jacobは、1998年から2001年にかけてマンチェスター大学で土木工学の第一級優等学士号（BEng）を取得しました。1999年にロンドンで最初のソフトウェアビジネスを立ち上げ、2005年には最初の.NETコンポーネントを作成し、Microsoftエコシステムにおける複雑な問題の解決を専門にしました。

彼の旗艦製品であるIronPDFとIronSuite .NETライブラリは、全世界で3000万以上のNuGetインストールを達成しており、彼の基本コードが世界中で使用されている開発者ツールを支えています。商業的な経験を25年間積み、コードを書くことを41年間続けるJacobは、企業向けのC#、Java、およびPython PDF技術の革新を推進し続け、次世代の技術リーダーを指導しています。

Humanizerは、C#における入力文字列を文に変換するための多数のツールと拡張メソッドを提供します。

Microsoft.Extensions.Caching.Memory...

顧客ハイライト:

開発者スポットライト:

ウェビナー:

OpenAPI .NET（開発者向けの動作方法）

.NETでのOpenAPIの設定

ステップ1: Swashbuckleのインストール

ステップ2: Swashbuckleの設定

APIドキュメントの生成と表示

OpenAPI定義の使用

カスタム注釈によるOpenAPIの拡張

例: カスタム注釈

出力

IronPDF

API呼び出しに対する応答としてPDFファイルを取得

結論

よくある質問

ASP.NETアプリケーションでHTMLコンテンツをPDFに変換するにはどうすればいいですか？

OpenAPIは.NETエコシステムにおいてどのような役割を果たしていますか？

.NETプロジェクトでSwashbuckleを使ってSwagger UIを設定するにはどうすればいいですか？

.NETでOpenAPI定義からクライアントSDKを生成するにはどうすればいいですか？

OpenAPIドキュメントでカスタムアノテーションを使用する利点は何ですか？

ASP.NET CoreでPDFファイルをAPIレスポンスとして配信するにはどうすればいいですか？

OpenAPIとPDF生成ツールの組み合わせがASP.NETアプリケーションにもたらす利点は何ですか？

OpenAPI .NET（開発者向けの動作方法）

.NETでのOpenAPIの設定

ステップ1: Swashbuckleのインストール

ステップ2: Swashbuckleの設定

APIドキュメントの生成と表示

OpenAPI定義の使用

カスタム注釈によるOpenAPIの拡張

例: カスタム注釈

出力

IronPDF

API呼び出しに対する応答としてPDFファイルを取得

結論

よくある質問

ASP.NETアプリケーションでHTMLコンテンツをPDFに変換するにはどうすればいいですか？

OpenAPIは.NETエコシステムにおいてどのような役割を果たしていますか？

.NETプロジェクトでSwashbuckleを使ってSwagger UIを設定するにはどうすればいいですか？

.NETでOpenAPI定義からクライアントSDKを生成するにはどうすればいいですか？

OpenAPIドキュメントでカスタムアノテーションを使用する利点は何ですか？

ASP.NET CoreでPDFファイルをAPIレスポンスとして配信するにはどうすればいいですか？

OpenAPIとPDF生成ツールの組み合わせがASP.NETアプリケーションにもたらす利点は何ですか？

関連する記事

CLIの簡素化と.NETの橋渡し：Curl DotNetとIronPDFを使う

RandomNumberGenerator C#

C# String Equals（開発者向けの仕組み）

Next step: Start free 30-day Trial

Next step: Start free 30-day Trial

世界中の数百万人のエンジニアから信頼されています。