3. Resume Downloads ⭐

var result = await httpClient.DownloadWithResumeAsync(
    url: "https://example.com/huge.zip",
    filePath: "huge.zip",
    progress: progress,
    maxRetries: 5);

4. Range Downloads ⭐

// Download bytes 1000-2000
var result = await httpClient.DownloadRangeAsync(url, 1000, 2000);

// Download from 5000 to end
var result = await httpClient.DownloadRangeAsync(url, 5000);

5. Pre-Download Info ⭐

// Check file size
var size = await httpClient.GetFileSizeAsync(url);
Console.WriteLine($"File size: {size} bytes");

// Check resume support
var supportsResume = await httpClient.SupportsRangeDownloadsAsync(url);

6. With Cancellation ⭐

using var cts = new CancellationTokenSource();

var result = await httpClient.DownloadToFileAsync(
    url, 
    path, 
    progress, 
    cts.Token);

📤 Upload Guide (Complete)

1. Single File

[Post("/upload")]
Task<string> Upload([Multipart] FileContent file);

// From file
var file = FileContent.FromFile("document.pdf");
await api.Upload(file);

// From bytes
var file = FileContent.FromBytes("file.jpg", bytes, "image/jpeg");
await api.Upload(file);

// From stream
var file = FileContent.FromStream("video.mp4", stream, "video/mp4");
await api.Upload(file);

2. Multiple Files

[Post("/upload-multiple")]
Task<string> UploadMultiple([Multipart] MultipartContent files);

var content = new MultipartContent();
content.AddFile(FileContent.FromFile("file1.pdf"));
content.AddFile(FileContent.FromFile("file2.jpg"));
content.AddField("description", "My files");
await api.UploadMultiple(content);

🎯 Core Features

CancellationToken

[Get("/users")]
Task<List<User>> GetUsers(CancellationToken ct = default);

using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var users = await api.GetUsers(cts.Token);

Response Headers

[Get("/users/{id}")]
Task<ApiResponse<User>> GetUser(int id);

var response = await api.GetUser(123);
Console.WriteLine($"ETag: {response.GetHeader("ETag")}");
var user = response.Content;

Per-Request Timeout

[Get("/users/{id}", TimeoutSeconds = 5)]
Task<User> GetUserFast(int id);

[Get("/reports", TimeoutSeconds = 300)]
Task<Report> GenerateReport();

Query Parameters

[Get("/users")]
Task<List<User>> Search(
    [Query] string search,
    [Query] int page = 1);

// Generates: /users?search=john&page=1
var users = await api.Search("john", 1);

Form Data

[Post("/login")]
Task<Token> Login([Form] LoginData data);

var token = await api.Login(new LoginData 
{ 
    Username = "user", 
    Password = "pass" 
});

📚 Complete Features

HTTP Methods

[Get] [Post] [Put] [Delete] [Patch]

Parameter Attributes

[Body] [Query] [Header] [Multipart] [Form]

Return Types

Task Task<T> ValueTask<T> Task<ApiResponse<T>>

Download Methods (HttpClient Extensions)

• DownloadFileAsync() - With progress
• DownloadToFileAsync() - Stream to disk
• DownloadRangeAsync() - Partial download
• DownloadWithResumeAsync() - Auto-resume
• GetFileSizeAsync() - Check size
• SupportsRangeDownloadsAsync() - Check resume

Configuration

• ✅ Retry policies (Polly)
• ✅ Logging
• ✅ HttpClientFactory
• ✅ Dependency injection
• ✅ Custom JSON
• ✅ Timeouts
• ✅ Headers

🏗️ Dependency Injection

services.AddApiClient<IUserApi>(options =>
{
    options.BaseUrl = "https://api.example.com";
    options.Timeout = TimeSpan.FromSeconds(30);
    options.RetryPolicy.MaxRetryAttempts = 3;
});

⚠️ Error Handling

try
{
    var user = await api.GetUser(999);
}
catch (ApiException ex)
{
    Console.WriteLine($"Status: {ex.StatusCode}");
    Console.WriteLine($"Content: {ex.Content}");
}
catch (OperationCanceledException)
{
    Console.WriteLine("Cancelled");
}
catch (TimeoutException)
{
    Console.WriteLine("Timeout");
}

📊 Comparison

📝 Version History

• v1.2.0 (2025-12-10): Enhanced downloads (progress, resume, streaming)
• v1.1.0 (2025-12-10): File upload, CancellationToken, response headers
• v1.0.0 (2025-12-09): Initial release

🎯 Summary

RoyceLark.ApiClient provides:

✅ Complete HTTP client functionality
✅ File upload (all sources)
✅ Enhanced downloads (progress, resume)
✅ CancellationToken support
✅ Response headers access
✅ Retry & timeout policies
✅ Production-ready

Everything you need for HTTP APIs! 🚀

📄 License

MIT License

🔗 Links

• GitHub
• NuGet
• Changelog

Made with ❤️ for the .NET community