Ecommerce Search 26.4

Changes

Upgrade instructions

C# SDK: Admin API migrated to Minimal APIs

The Ecommerce Search Admin API has been migrated to ASP.NET Core Minimal APIs. This regenerated the C# Admin SDK clients (Bizzkit.Sdk.EcommerceSearch and Bizzkit.Sdk.EcommerceSearch.Preview) and introduces two breaking changes for consumers of those packages. The Search API SDK (Bizzkit.Sdk.Search) is unaffected.

Error responses are now typed as HttpValidationProblemDetails

Admin API error responses — such as 400 Bad Request, 404 Not Found, and 409 Conflict — were previously deserialized as ProblemDetails (and ValidationProblemDetails for some status codes). They are now consistently typed as HttpValidationProblemDetails. This affects both the Bizzkit.Sdk.EcommerceSearch and Bizzkit.Sdk.EcommerceSearch.Preview clients.

Code that catches the typed API exception must be updated to use the new type:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

// Before
catch (SearchApiException<ProblemDetails> ex)
{
    // handle validation error
}

// After
catch (SearchApiException<HttpValidationProblemDetails> ex)
{
    // handle validation error
}

Preview SDK operations now carry a Preview suffix

In Bizzkit.Sdk.EcommerceSearch.Preview, every operation method name now ends with Preview before the Async suffix, aligning the preview operation IDs with the platform naming conventions. Update all calls to the Preview client accordingly. For example:

The method names on the non-preview Bizzkit.Sdk.EcommerceSearch client are unchanged.

New features

None.

Enhancements

None.

Deprecations

None.