INTEGRÁCIÓS ÚTMUTATÓ · .NET & BACKEND

Az ASP.NET alapvető kapcsolatfelvételi űrlap integrációja (minimális API-k és borotva)

A kapcsolatfelvételi űrlapok biztonságos továbbítása az ASP.NET Core Minimal API-kból vagy a Razor Pagesből a Lugatu felé az IHttpClientFactory, szerveroldali API-kulcsok és automatikus idempotenciakulcsok használatával.

Csatlakoztassa a .NET Projectet → Funkciók és korlátok megtekintése

1. Minimális API-végpont az IHttpClientFactory segítségével

Az ASP.NET Core Minimal API-k letisztult, nagy teljesítményű módot biztosítanak a kapcsolatfelvételi űrlapok beküldésére és biztonságos továbbítására a Lugatu felé az IHttpClientFactory és egy Idempotency-Key használatával.

Program.cs csharp

using System.Net.Http.Headers;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);

// Register resilient Lugatu HTTP client
builder.Services.AddHttpClient("Lugatu", client =>
{
    client.BaseAddress = new Uri("https://www.lugatu.com");
    client.DefaultRequestHeaders.Authorization =
        new AuthenticationHeaderValue("Bearer", builder.Configuration["Lugatu:ApiKey"]);
});

var app = builder.Build();

app.MapPost("/api/contact", async (ContactRequest request, IHttpClientFactory clientFactory, IConfiguration config) =>
{
    // 1. Silent rejection for automated bot traps
    if (!string.IsNullOrEmpty(request.Gotcha))
    {
        return Results.Ok(new { success = true });
    }

    var client = clientFactory.CreateClient("Lugatu");
    var formId = config["Lugatu:FormId"];

    var payload = new
    {
        fields = new Dictionary<string, string?>
        {
            ["name"] = request.Name,
            ["email"] = request.Email,
            ["message"] = request.Message,
        }
    };

    using var message = new HttpRequestMessage(HttpMethod.Post, $"/api/v1/forms/{formId}/submissions")
    {
        Content = new StringContent(JsonSerializer.Serialize(payload), System.Text.Encoding.UTF8, "application/json")
    };

    // Ensure at-most-once delivery with Idempotency-Key
    message.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());

    var response = await client.SendAsync(message);
    if (!response.IsSuccessStatusCode)
    {
        return Results.StatusCode((int)response.StatusCode);
    }

    return Results.Ok(new { success = true });
});

app.Run();

public record ContactRequest(string Name, string Email, string Message, string? Gotcha);

2. Konfiguráció az appsettings.json fájlban

Tárolja biztonságosan Lugatu hitelesítő adatait az ASP.NET Core konfigurációs szolgáltatók segítségével. Éles környezetben használja az Azure Key Vault, az AWS Secrets Manager vagy a környezeti változókat.

appsettings.json json

{
  "Lugatu": {
    "FormId": "YOUR_FORM_GUID",
    "ApiKey": "lug_live_your_secret_server_key"
  }
}

3. Razor Pages Controller megvalósítása

Hagyományos többoldalas ASP.NET Core MVC vagy Razor Pages alkalmazások esetén továbbítsa az űrlapok beküldését az OnPostAsync-en belül, miközben élvezheti az ASP.NET Core beépített Antiforgery token ellenőrzését.

Pages/Contact.cshtml.cs csharp

public class ContactModel : PageModel
{
    private readonly IHttpClientFactory _clientFactory;
    private readonly string _formId;

    public ContactModel(IHttpClientFactory clientFactory, IConfiguration config)
    {
        _clientFactory = clientFactory;
        _formId = config["Lugatu:FormId"]!;
    }

    [BindProperty]
    public ContactInput Input { get; set; } = new();

    public async Task<IActionResult> OnPostAsync()
    {
        if (!ModelState.IsValid || !string.IsNullOrEmpty(Input.Gotcha))
        {
            return Page();
        }

        var client = _clientFactory.CreateClient("Lugatu");
        var content = new StringContent(
            JsonSerializer.Serialize(new { fields = Input }),
            System.Text.Encoding.UTF8,
            "application/json");

        content.Headers.Add("Idempotency-Key", Guid.NewGuid().ToString());

        var res = await client.PostAsync($"/api/v1/forms/{_formId}/submissions", content);
        if (res.IsSuccessStatusCode)
        {
            return RedirectToPage("/ContactSuccess");
        }

        ModelState.AddModelError(string.Empty, "Unable to deliver inquiry. Please try again.");
        return Page();
    }
}

Biztonsági és hitelesítési változatlan

Technikai változat: A szerverek közötti API-kulcsokat (lug_live_...) szigorúan a háttérben kell tartani. Tárolja őket az appsettings.json vagy a secrets vaults fájlban; soha ne továbbítson élő kulcsokat az ügyfélböngészőknek.

Hibaelhárítás és gyakori lenyelési hibák

HTTP 401 Jogosulatlan válasz a Lugatu API-tól

Ellenőrizze, hogy az API-kulcs a lug_live_ karakterlánccal kezdődik, és átkerült-e az Authorization: Bearer fejlécbe. Győződjön meg arról, hogy az API-kulcs a megcélzott űrlapazonosítót tartalmazó munkaterülethez tartozik.

Gyakran Ismételt Kérdések

Miért használjam az IHttpClientFactory-t egy új HttpClient példány létrehozása helyett?

Az IHttpClientFactory kezeli a socket pooling-et, és megakadályozza a socketek kimerülését nagy terhelés mellett az ASP.NET Core alkalmazásokban.

Készen áll az űrlapvégpont létrehozására?

Kezdje el ingyen másodpercek alatt. Hitelkártya nem szükséges.

Kezdje ingyenesen →