원시 텍스트를 다듬고 SEO‑친화적인 콘텐츠로 변환하는 것은 콘텐츠가 풍부한 웹 애플리케이션을 구축하는 많은 .NET 개발자들에게 매일 겪는 과제입니다. GroupDocs.Rewriter Cloud SDK for .NET은 의미를 유지하면서 문장을 재작성하는 강력한 API를 제공합니다. 이 단계별 가이드는 ASP.NET Core MVC와 통합하는 방법을 보여주며, 라이브러리 설정, 자격 증명 구성, 컨트롤러에서 재작성 로직 구현, 그리고 Razor 뷰에 결과를 렌더링하는 과정을 다룹니다.

사용 사례 요구 사항

사용자 생성 기사, 제품 설명 또는 마케팅 카피를 생성하는 기업은 수동 편집 없이 가독성을 향상시켜야 할 필요가 있습니다. 이러한 시나리오에 대한 요구 사항은 다음과 같습니다:

  • 웹 양식에서 직접 실시간 텍스트 재작성.
  • 서버 측에서 API 자격 증명을 안전하게 처리.
  • 기존 ASP.NET Core MVC 파이프라인과 원활한 통합.

일반적인 문자열 조작 코드를 사용하면 오류가 발생하기 쉽고 확장성이 떨어지므로, 전용 문서 재작성 라이브러리가 필수적입니다.

작업을 위한 GroupDocs.Rewriter Cloud SDK for .NET 선택

GroupDocs.Rewriter Cloud SDK for .NET은 REST 기반 API를 제공하며, 다중 언어 지원, 사용자 정의 재작성 모드 및 고성능 처리를 지원합니다. 사용 사례에 맞는 주요 기능은 다음과 같습니다:

  • RewriteModeEnum.Rewrite - 입력 텍스트를 자연어 형태로 다시 작성합니다.
  • DI‑friendly client - ASP.NET Core 서비스 컨테이너에 싱글톤으로 등록할 수 있습니다.
  • Strong typing and async support - 최신 .NET 비동기 패턴에 자연스럽게 맞습니다.

단계별 가이드인 ASP.NET Core MVC와 통합은 이러한 기능이 요구 사항에 어떻게 매핑되는지 보여줍니다. 자세한 API 정보는 공식 문서와 API 참조를 확인하십시오.

ASP.NET Core MVC와 통합하기 위한 단계별 구현 가이드

이 단계별 가이드는 ASP.NET Core MVC와 통합하는 방법을 안내하고, 필요한 모든 구성 단계를 차례대로 설명합니다.

SDK 패키지 설치

프로젝트에 NuGet 패키지를 추가합니다.

dotnet add package GroupDocs.Rewriter-Cloud

바이너리를 다운로드 페이지에서 다운로드할 수도 있습니다.

Rewriter 자격 증명 구성 추가

구성에 AppSid와 AppKey를 배치하십시오. 아래 스니펫은 간단히 메모리 내에 추가합니다.

builder.Configuration.AddInMemoryCollection(new[]
{
    new KeyValuePair<string,string>("GroupDocsRewriter:AppSid", "YOUR_APP_SID"),
    new KeyValuePair<string,string>("GroupDocsRewriter:AppKey", "YOUR_APP_KEY")
});

DI에 Rewriter API 클라이언트 등록

SDK 클라이언트는 싱글톤으로 등록되어 컨트롤러에 주입될 수 있습니다.

builder.Services.Configure<RewriterSettings>(builder.Configuration.GetSection("GroupDocsRewriter"));

builder.Services.AddSingleton<IRewriterApi>(sp =>
{
    var settings = sp.GetRequiredService<IOptions<RewriterSettings>>().Value;
    var config = new Configuration
    {
        AppSid = settings.AppSid,
        AppKey = settings.AppKey
    };
    return new RewriterApi(config);
});

MVC 컨트롤러 및 뷰 모델 만들기

컨트롤러는 원본 텍스트를 받아 Rewriter API를 호출하고, 재작성된 결과를 반환합니다.

public class RewriterController : Controller
{
    private readonly IRewriterApi _rewriterApi;

public RewriterController(IRewriterApi rewriterApi)
    {
        _rewriterApi = rewriterApi;
    }

[HttpGet]
    public IActionResult Index()
    {
        return View(new RewriterViewModel());
    }

[HttpPost]
    public async Task<IActionResult> Index(RewriterViewModel model)
    {
        if (!ModelState.IsValid)
        {
            return View(model);
        }

var rewriteRequest = new RewriteRequest
        {
            Text = model.InputText,
            Language = "en",
            TargetLanguage = "en",
            RewriteMode = RewriteModeEnum.Rewrite
        };

RewriteResponse response = await _rewriterApi.RewriteAsync(rewriteRequest);
        model.OutputText = response?.Result?.Text ?? string.Empty;

return View(model);
    }
}

동봉된 뷰 모델은 입력 및 출력 문자열을 보유합니다.

public class RewriterViewModel
{
    [Required]
    [Display(Name = "Original Text")]
    public string InputText { get; set; } = string.Empty;

[Display(Name = "Rewritten Text")]
    public string OutputText { get; set; } = string.Empty;
}

텍스트 입력 및 출력을 위한 Razor 뷰 만들기

Razor 페이지는 간단한 양식을 제공하고, 사용 가능한 경우 재작성된 텍스트를 표시합니다.

@model RewriterViewModel
@{
    ViewData["Title"] = "Text Rewriter";
}
<h2>@ViewData["Title"]</h2>

<form asp-action="Index" method="post" class="form-horizontal">
    <div class="form-group">
        <label asp-for="InputText" class="control-label"></label>
        <textarea asp-for="InputText" class="form-control" rows="6"></textarea>
        <span asp-validation-for="InputText" class="text-danger"></span>
    </div>
    <div class="form-group">
        <button type="submit" class="btn btn-primary">Rewrite</button>
    </div>
</form>

@if (!string.IsNullOrWhiteSpace(Model.OutputText))
{
    <hr />
    <h4>Rewritten Text</h4>
    <textarea class="form-control" rows="6" readonly>@Model.OutputText</textarea>
}

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

ASP.NET Core MVC에서 문서 재작성을 위한 전체 작업 예제

아래 예제에는 솔루션을 실행하는 데 필요한 전체 소스 파일이 포함되어 있습니다.

// ---------------------------------------------------
// Program.cs
// ---------------------------------------------------
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Options;
using GroupDocs.Rewriter.Cloud.Sdk.Api;
using GroupDocs.Rewriter.Cloud.Sdk.Client;
using GroupDocs.Rewriter.Cloud.Sdk.Model.Requests;
using GroupDocs.Rewriter.Cloud.Sdk.Model;
using System.Threading.Tasks;

var builder = WebApplication.CreateBuilder(args);

// Add configuration for GroupDocs Rewriter credentials
builder.Configuration.AddInMemoryCollection(new[]
{
    new KeyValuePair<string,string>("GroupDocsRewriter:AppSid", "YOUR_APP_SID"),
    new KeyValuePair<string,string>("GroupDocsRewriter:AppKey", "YOUR_APP_KEY")
});

builder.Services.Configure<RewriterSettings>(builder.Configuration.GetSection("GroupDocsRewriter"));

// Register GroupDocs Rewriter API client in DI
builder.Services.AddSingleton<IRewriterApi>(sp =>
{
    var settings = sp.GetRequiredService<IOptions<RewriterSettings>>().Value;
    var config = new Configuration
    {
        AppSid = settings.AppSid,
        AppKey = settings.AppKey
    };
    return new RewriterApi(config);
});

builder.Services.AddControllersWithViews();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
}
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Rewriter}/{action=Index}/{id?}");

app.Run();

// ---------------------------------------------------
// RewriterSettings.cs
// ---------------------------------------------------
public class RewriterSettings
{
    public string AppSid { get; set; } = string.Empty;
    public string AppKey { get; set; } = string.Empty;
}

// ---------------------------------------------------
// Models/RewriterViewModel.cs
// ---------------------------------------------------
using System.ComponentModel.DataAnnotations;

public class RewriterViewModel
{
    [Required]
    [Display(Name = "Original Text")]
    public string InputText { get; set; } = string.Empty;

[Display(Name = "Rewritten Text")]
    public string OutputText { get; set; } = string.Empty;
}

// ---------------------------------------------------
// Controllers/RewriterController.cs
// ---------------------------------------------------
using Microsoft.AspNetCore.Mvc;
using System.Threading.Tasks;

public class RewriterController : Controller
{
    private readonly IRewriterApi _rewriterApi;

public RewriterController(IRewriterApi rewriterApi)
    {
        _rewriterApi = rewriterApi;
    }

[HttpGet]
    public IActionResult Index()
    {
        return View(new RewriterViewModel());
    }

[HttpPost]
    public async Task<IActionResult> Index(RewriterViewModel model)
    {
        if (!ModelState.IsValid)
        {
            return View(model);
        }

// Build request for the Rewriter API
        var rewriteRequest = new RewriteRequest
        {
            Text = model.InputText,
            Language = "en",               // source language
            TargetLanguage = "en",         // target language (same for rewriting)
            RewriteMode = RewriteModeEnum.Rewrite // choose rewrite mode
        };

// Call the API
        RewriteResponse response = await _rewriterApi.RewriteAsync(rewriteRequest);

// Populate the view model with the rewritten text
        model.OutputText = response?.Result?.Text ?? string.Empty;

return View(model);
    }
}

// ---------------------------------------------------
// Views/Rewriter/Index.cshtml
// ---------------------------------------------------
@model RewriterViewModel
@{
    ViewData["Title"] = "Text Rewriter";
}
<h2>@ViewData["Title"]</h2>

<form asp-action="Index" method="post" class="form-horizontal">
    <div class="form-group">
        <label asp-for="InputText" class="control-label"></label>
        <textarea asp-for="InputText" class="form-control" rows="6"></textarea>
        <span asp-validation-for="InputText" class="text-danger"></span>
    </div>
    <div class="form-group">
        <button type="submit" class="btn btn-primary">Rewrite</button>
    </div>
</form>

@if (!string.IsNullOrWhiteSpace(Model.OutputText))
{
    <hr />
    <h4>Rewritten Text</h4>
    <textarea class="form-control" rows="6" readonly>@Model.OutputText</textarea>
}

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

cURL을 사용한 REST API를 통한 문서 재작성 실행

아래는 GroupDocs Rewriter REST 엔드포인트를 통해 동일한 재작성 작업을 수행하는 간단한 cURL 워크플로우입니다.

인증 및 액세스 토큰 가져오기

curl -X POST "https://api.groupdocs.cloud/v1/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

응답은 이후 호출에서 사용할 access_token을 반환합니다.

소스 텍스트 업로드 (대용량 파일에 대해 선택 사항)

curl -X POST "https://api.groupdocs.cloud/v1/storage/file/upload" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.txt"

Rewrite 작업 실행

curl -X POST "https://api.groupdocs.cloud/v1/rewriter/rewrite" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "text": "Your original text goes here.",
           "language": "en",
           "targetLanguage": "en",
           "rewriteMode": "Rewrite"
         }'

JSON 응답에는 result.text 필드에 재작성된 텍스트가 포함됩니다.

결과 다운로드 (파일로 저장한 경우)

curl -X GET "https://api.groupdocs.cloud/v1/storage/file/download?path=output.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o rewritten.txt

요청 매개변수 및 응답 형식에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

최종 생각

ASP.NET Core MVC 프로젝트에 GroupDocs.Rewriter Cloud SDK for .NET을 통합하는 것은 단계별 가이드를 따라 하면 간단합니다. 이 라이브러리는 자연어 재작성의 복잡한 작업을 처리하므로 UI와 비즈니스 로직에 집중할 수 있습니다. AppSid와 AppKey를 안전하게 보관하고, 평가를 위해 임시 라이선스를 사용하며, 프로덕션 작업을 위해 정식 라이선스로 업그레이드하는 것을 기억하세요. 코드와 cURL 예제를 활용하면 이제 모든 .NET 웹 애플리케이션에 지능형 텍스트 재작성을 추가할 수 있습니다.

자주 묻는 질문

ASP.NET Core MVC와 통합하는 단계별 가이드가 API의 오류 응답을 어떻게 처리합니까?
컨트롤러 예제는 API를 호출하기 전에 ModelState.IsValid를 확인하고 RewriteResponse를 캡처합니다. API가 오류를 반환하면 response 객체가 null이 되며, 뷰는 단순히 빈 출력만 표시합니다. 자세한 오류 처리 방법은 공식 문서를 참조하십시오.

Can I rewrite documents other than plain text, such as DOCX or PDF, using the same approach?
예. Rewriter API는 지원되는 형식에서 추출한 원시 텍스트를 허용합니다. 먼저 GroupDocs.Parser 또는 GroupDocs.Conversion을 사용하여 텍스트를 추출한 다음 재작성 엔드포인트에 전달할 수 있습니다. 두 SDK 모두 GroupDocs 제품군에 나열되어 있습니다.

고 트래픽 웹 사이트에서 rewrite 작업을 비동기적으로 실행할 수 있나요?
확실히 가능합니다. 컨트롤러는 await _rewriterApi.RewriteAsync(...)를 사용하며, 이는 완전히 비동기이며 ASP.NET Core의 async 파이프라인과 함께 확장됩니다. 이는 ASP.NET Core MVC와 통합하기 위한 단계별 가이드에 보여진 패턴에 맞습니다.

테스트용 임시 라이선스는 어디서 얻을 수 있나요?
임시 라이선스는 임시 라이선스 페이지에서 제공됩니다. 구매를 확정하지 않고 SDK를 평가할 수 있습니다.

추가 읽을거리