BookingApi.Client 1.0.1

BookingApi.Client

A .NET Standard 2.0 library for interacting with the Bili Order Service API. This client provides methods for submitting, tracking, and cancelling orders via HTTP or Refit-based APIs, and is designed for easy integration with dependency injection and configuration in .NET applications.

Features

• Submit new orders to the Bili Order Service.
• Track the status of existing orders.
• Cancel orders.
• Strongly-typed request and response models.
• Configurable via IConfiguration or code.
• Supports dependency injection via IServiceCollection.
• Built-in support for Polly resilience policies (if desired).

Getting Started

Installation

Add a reference to the BookingApi.Client project or package in your .NET Standard 2.0+ or .NET Core/.NET 5+ application.

Configuration

You can configure the client using appsettings or code.

Using appsettings.json

{ 
"BiliOrderClient": 
    { 
    "BaseUrl": "https://api.biliorder.com", 
    "UserName": "your-username", 
    "Password": "your-password", 
    "Authtoken": "your-auth-token" 
    }
}

Registering with Dependency Injection

using BookingApi.Client; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection;
var services = new ServiceCollection(); services.AddBiliOrderClient(configuration); // where 'configuration' is your IConfiguration instance

Or configure via code:

services.AddBiliOrderClient(options => { options.BaseUrl = "https://api.biliorder.com"; options.UserName = "your-username"; options.Password = "your-password"; options.Authtoken = "your-auth-token"; });

Usage

Inject IBookingApiClient into your service or controller:

public class OrderService 
{
    private readonly IBookingApiClient _client;
    public OrderService(IBookingApiClient client)
    {
        _client = client;
    }

    public async Task SubmitOrderAsync()
    {
        var request = new OrderSubmissionRequest
        {
            MerOrderRef = "12345",
            // ... set other properties
        };

        var response = await _client.SubmitOrderAsync(request);
        // handle response
    }
}

API Overview

• Task<OrderSubmissionResponse> SubmitOrderAsync(OrderSubmissionRequest request)
• Task<OrderTrackingResponse> TrackOrderAsync(OrderTrackingRequest request)
• Task<OrderCancellationResponse> CancelOrderAsync(OrderCancellationRequest request)

Models

All request and response models are available under the BookingApi.Client.Common namespace.

Advanced

• The client uses Newtonsoft.Json for serialization.
• You can customize HTTP client behavior or add Polly policies by extending the registration in ServiceCollectionExtensions.

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please open issues or submit pull requests f