ASP.NET Core PDF417 Driver License API

Designing a Safe PDF417 Route in ASP.NET Core

A production ASP.NET Core integration must protect the API key, reject oversized uploads, preserve enough image quality for decoding, and translate recoverable 422 responses into a useful capture experience. A browser-only request would expose credentials and make abuse controls harder.

A Server-Side ASP.NET Core Integration

ASP.NET Core can stream the uploaded image into memory, encode it once, and preserve StructOCR status codes for the client capture flow. The PDF417 API reference documents the complete response and error model. Identity fields are only returned after deterministic barcode decoding and AAMVA parsing.

Where This Workflow Fits

• Protected upload endpoint: Keep STRUCTOCR_API_KEY inside ASP.NET Core server configuration rather than client code.
• Structured form prefill: Map normalized AAMVA fields into an editable form and require user or staff confirmation.
• Recoverable retake flow: Turn PDF417_NOT_DECODED into a clear request for a sharper, complete license-back image.

ASP.NET Core PDF417 Endpoint

The example accepts image data on the server and calls /v1/driver-license-pdf417. Adapt authentication, authorization, rate limits, and retention to your application.

Prerequisite: .NET 8 or later; configure STRUCTOCR_API_KEY on the server

using System.Net.Http.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient();
var app = builder.Build();

app.MapPost("/api/license/pdf417", async (IFormFile image, IHttpClientFactory factory) =>
{
    if (image.Length > 4_500_000) return Results.StatusCode(413);
    await using var stream = image.OpenReadStream();
    using var memory = new MemoryStream();
    await stream.CopyToAsync(memory);

    var http = factory.CreateClient();
    http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("STRUCTOCR_API_KEY"));
    var response = await http.PostAsJsonAsync("https://api.structocr.com/v1/driver-license-pdf417", new { img = Convert.ToBase64String(memory.ToArray()) });
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json", statusCode: (int)response.StatusCode);
});

app.Run();

ASP.NET Core Response Shape

The example contains fictional identity values. Optional AAMVA elements can be null, and production logs should avoid storing raw identity data.

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "source": "pdf417",
    "country_code": "USA",
    "region": "CA",
    "document_number": "SAMPLE1234",
    "surname": "SAMPLE",
    "given_names": "ALEX MORGAN",
    "first_name": "ALEX",
    "middle_name": "MORGAN",
    "sex": "X",
    "date_of_birth": "1990-01-15",
    "date_of_issue": "2025-01-15",
    "date_of_expiry": "2030-01-15",
    "address": "100 EXAMPLE AVE",
    "city": "SAMPLE CITY",
    "postal_code": "00000",
    "vehicle_class": "C",
    "restrictions": null,
    "endorsements": null,
    "document_discriminator": "SAMPLE-DISCRIMINATOR",
    "issuer_identification_number": null,
    "aamva_version": 10,
    "jurisdiction_version": 0
  }
}