Introduction

LuduvoDotNet is a .NET client for the Luduvo API. It provides typed models, async methods, and domain-specific exceptions for common API errors.

Main features

• Authentication via Luduvo.LoginAsync(identifier, password).
• Authenticated client creation via new Luduvo(token).
• User profile lookup with GetUserByIdAsync.
• User headshot download with GetUserHeadshot.
• User search with SearchUsersAsync and lightweight PartialUser results.
• User inventory lookup with GetUserInventotoryAsync (experimental).
• Authenticated profile update with UpdateMyProfileAsync (PUT /me/profile).
• Place lookup with GetPlaceByIdAsync.
• Place search with SearchPlacesAsync (supports pagination via limit and offset).
• Store search with SearchStoreAsync (supports pagination via limit and offset).
• Store item lookup with GetStoreItemByIdAsync.

Error handling

The client maps selected HTTP statuses to custom exceptions:

• 404 on place endpoints -> PlaceNotFoundException
• 404 on user profile endpoint -> UserNotFoundException
• 404 on store item endpoint -> StoreItemNotFoundException
• 429 -> TooManyRequestsException

Other non-success responses raise HttpRequestException via EnsureSuccessStatusCode().

Luduvo API (general)

If you also want API-level context (route behavior, payload shape, paging conventions), see:

• API Overview
• Authentication
• Endpoints
• Pagination and Errors

Learn by examples

• Tutorial: Get User By ID
• Tutorial: Search Users
• Tutorial: Get User Inventory
• Tutorial: Get Place By ID
• Tutorial: Search Places
• Tutorial: Search Store
• Tutorial: Get Store Item By ID