Home / మార్గదర్శకులు / ASP.NET కోర్ కాంటాక్ట్ ఫారమ్ ఇంటిగ్రేషన్ (కనీస APIలు & రేజర్)
ఇంటిగ్రేషన్ గైడ్ · .NET & బ్యాకెండ్

ASP.NET కోర్ కాంటాక్ట్ ఫారమ్ ఇంటిగ్రేషన్ (కనీస APIలు & రేజర్)

IHttpClientFactory, సర్వర్-సైడ్ API కీలు మరియు ఆటోమేటిక్ idempotency కీలను ఉపయోగించి ASP.NET కోర్ మినిమల్ APIలు లేదా రేజర్ పేజీల నుండి Lugatuకి సురక్షితంగా సంప్రదింపు ఫారమ్ సమర్పణలను ఫార్వార్డ్ చేయండి.

1. IHttpClientFactoryతో కనిష్ట API ఎండ్‌పాయింట్

ASP.NET కోర్ మినిమల్ APIలు సంప్రదింపు ఫారమ్ సమర్పణలను స్వీకరించడానికి మరియు IHttpClientFactory మరియు Idempotency-కీని ఉపయోగించి వాటిని సురక్షితంగా Lugatuకి ఫార్వార్డ్ చేయడానికి శుభ్రమైన, అధిక-పనితీరు గల మార్గాన్ని అందిస్తాయి.

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. appsettings.jsonలో కాన్ఫిగరేషన్

ASP.NET కోర్ కాన్ఫిగరేషన్ ప్రొవైడర్‌లను ఉపయోగించి మీ Lugatu ఆధారాలను సురక్షితంగా నిల్వ చేయండి. ఉత్పత్తిలో, అజూర్ కీ వాల్ట్, AWS సీక్రెట్స్ మేనేజర్ లేదా ఎన్విరాన్‌మెంట్ వేరియబుల్స్‌ని ఉపయోగించండి.

appsettings.json json
{
  "Lugatu": {
    "FormId": "YOUR_FORM_GUID",
    "ApiKey": "lug_live_your_secret_server_key"
  }
}

3. రేజర్ పేజీల కంట్రోలర్ అమలు

సాంప్రదాయ బహుళ-పేజీ ASP.NET కోర్ MVC లేదా రేజర్ పేజీల యాప్‌ల కోసం, ASP.NET కోర్ బిల్ట్-ఇన్ యాంటీఫోర్జరీ టోకెన్ వెరిఫికేషన్ నుండి ప్రయోజనం పొందుతున్నప్పుడు OnPostAsyncలో ఫారమ్ సమర్పణలను ఫార్వార్డ్ చేయండి.

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();
    }
}

భద్రత & ప్రమాణీకరణ మార్పులేనిది

సాంకేతిక మార్పులేనిది: సర్వర్-టు-సర్వర్ API కీలు (lug_live_...) ఖచ్చితంగా బ్యాకెండ్‌లో ఉంచబడాలి. వాటిని appsettings.json లేదా సీక్రెట్స్ వాల్ట్‌లలో నిల్వ చేయండి; క్లయింట్ బ్రౌజర్‌లకు ప్రత్యక్ష కీలను ఎప్పుడూ ప్రసారం చేయవద్దు.

ట్రబుల్షూటింగ్ & సాధారణ తీసుకోవడం లోపాలు

HTTP 401 Lugatu API నుండి అనధికార ప్రతిస్పందన

మీ API కీ lug_live_తో ప్రారంభమవుతుందని మరియు ఆథరైజేషన్: బేరర్ హెడర్‌లో పాస్ చేయబడిందని ధృవీకరించండి. API కీ లక్షిత ఫారమ్ IDని కలిగి ఉన్న కార్యస్థలానికి చెందినదని నిర్ధారించుకోండి.

తరచుగా అడిగే ప్రశ్నలు

నేను కొత్త HttpClient ఉదాహరణను సృష్టించడం కంటే IHttpClientFactoryని ఎందుకు ఉపయోగించాలి?

IHttpClientFactory సాకెట్ పూలింగ్‌ను నిర్వహిస్తుంది మరియు ASP.NET కోర్ అప్లికేషన్‌లలో భారీ లోడ్‌లో సాకెట్ ఎగ్జాషన్‌ను నిరోధిస్తుంది.

మీ ఫారమ్ ముగింపు బిందువుని సృష్టించడానికి సిద్ధంగా ఉన్నారా?

సెకన్లలో ఉచితంగా ప్రారంభించండి. క్రెడిట్ కార్డ్ అవసరం లేదు.

ఉచితంగా ప్రారంభించండి →