Lyo.Endato.Client 1.0.1

Lyo.Endato.Client

Typed HTTP client for the Endato data-enrichment REST API.

Archetype C (vendor client). Canonical people rows live in Lyo.People.Postgres (Archetype A); optional vendor cache in Lyo.Endato.Postgres (Archetype D). Host maps Endato DTOs → Person + person_source (EntitySourceRecord.From with EndatoPsPerson / EndatoCePerson on source_entity_*). See package layout.

Subclasses Lyo.Api.Client.ApiClient so JSON serialization, Accept-Encoding, and optional request compression behave the same as for any other Lyo HTTP client.

Examples

DI registration (Extensions.cs)

services.AddEndatoClientFromConfiguration(builder.Configuration);

// or:
services.AddEndatoClient(o => {
    o.BaseUrl = "https://api.endato.com";
    o.ApName = "your-ap-name";
    o.ApPassword = "your-ap-password";
});

DI registration (Extensions.cs) (2)

{
  "EndatoClient": {
    "BaseUrl": "https://api.endato.com",
    "ApName": "your-ap-name",
    "ApPassword": "your-ap-password"
  }
}

Surface

EndatoClient wires the two galaxy-API endpoints behind manager properties:

Both managers accept a built query or a PersonQueryBuilder / EnrichmentQueryBuilder.

Authentication is wired automatically: the client sets galaxy-ap-name / galaxy-ap-password headers from options on every request.

Models live under Models/Person (request + response, plus pagination) and Models/Enrichment.

Surface — Request builders

Person Search — see Person Search properties:

var query = PersonQueryBuilder.Create("Jane", "Doe", age: 42)
    .WithPhone("5125550100")
    .AddAddress("123 Main St", county: "Travis")
    .WithResultsPerPage(25)
    .Build();

var response = await client.Persons.QueryPersonsAsync(query, ct);
// or:
var response = await client.Persons.QueryPersonsAsync(
    PersonQueryBuilder.Create("Jane", "Doe", age: 42).WithPhone("5125550100"), ct);

Contact Enrichment — see Contact Enrichment properties. The API requires at least two of name, phone, email, or address; EnrichmentQueryBuilder.Build() enforces that:

var query = EnrichmentQueryBuilder.Create("John", "Smith")
    .WithPhone("5125550100")
    .WithAddress("123 Main St", "Austin, TX 78701")
    .Build();

var response = await client.Enrichment.QueryEnrichmentAsync(query, ct);

Surface — Numeric fields

EndatoClient uses LyoJsonSerializerOptions (AllowReadingFromString), so latitude/longitude deserialize into decimal? whether the API sends JSON numbers or quoted strings.

Options (EndatoClientOptions)

Configuration section: EndatoClient (shadows the base ApiClient section). Inherits all ApiClientOptions flags and adds:

BaseUrl is required (validated in the constructor); point it at https://api.endato.com (or another Endato environment).

DI registration (Extensions.cs)

All overloads register EndatoClient as a singleton, pulling ILoggerFactory and any registered HttpClient from DI.

Example appsettings.json:

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

• Lyo.Api.Client — (direct, lyo)
• Microsoft.Extensions.Configuration.Binder 10.0.5 — (direct, microsoft)
• Microsoft.Extensions.DependencyInjection.Abstractions 10.0.5 — (direct, microsoft)
• Microsoft.Extensions.Logging.Abstractions 10.0.5 — (direct, microsoft)
• Lyo.Api.Models — (transitive, lyo)
• Lyo.Common — (transitive, lyo)
• Lyo.DateAndTime — (transitive, lyo)
• Lyo.Diagnostic — (transitive, lyo)
• Lyo.Exceptions — (transitive, lyo)
• Lyo.Hashing — (transitive, lyo)
• Lyo.PackageMetadata — (transitive, lyo)
• Lyo.Query.Models — (transitive, lyo)
• Microsoft.Extensions.Http 10.0.5 — (transitive, microsoft)
• System.IO.Hashing 10.0.5 — (transitive, microsoft, net10.0)
• System.Memory 4.6.3 — (transitive, microsoft, netstandard2.0)
• System.Text.Json 10.0.5 — (transitive, microsoft, netstandard2.0)
• System.Threading.Tasks.Extensions 4.6.3 — (transitive, microsoft)