Digillect DaData.ru client

Implementation of the DaData features, based on HTTP Client through Refit.

Available features

• Address suggestions
• Address by FIAS/KLADR identifier
• City by IP address
• Organization (party) suggestions and find by INN
• Bank suggestions and find by BIC
• Full name (FIO) suggestions
• Passport issuing unit (FMS unit) suggestions and find by code
• Email suggestions

Usage

Register the client in DI container passing API key, if any:

services.AddDaDataSuggestionsClient("123456");

Then inject the client into your services/controllers:

[Route("/api/addresses")]
public sealed class AddressesController : ApiController
{
    private readonly IDaDataSuggestionsClient _client;
    
    public AddressesController(IDaDataSuggestionsClient client)
    {
        _client = client;
    }

    /// <summary>
    /// Suggests addresses for the specified query.
    /// </summary>
    [HttpGet("suggestions")]
    public Task<IReadOnlyList<AddressSuggestion>> GetSuggestionsAsync(string query) => _client.SuggestAddressAsync(query);
    
    /// <summary>
    /// Suggests cities for the specified query.
    /// </summary>
    [HttpGet("cities")]
    public async Task<IReadOnlyList<AddressSuggestion>> GetCitiesAsync(string query)
    {
        var request = SuggestAddressRequest.Create(query).From(SuggestAddressBound.City).To(SuggestAddressBound.City);
        var response = await _client.SuggestAddressAsync(request);
        
        return response.Suggestions;
    }
}