Описание

Этот проект представляет из себя .Net реализацию клиента для работы с сервисом DaData.ru
С ним вы сможете очень быстро начать работать с API DaData, без лишних затрат времени. Есть полная поддержка .Net Core и .Net Standart 1.3+

На данный момент полностью реализованы все методы для работы с API:

• Подсказки
• Стандартизация
• Дополнительные методы

RoadMap

• Добавить возможность автоматических уведомлений о превышении минимального, установленного вами лимита баланса
• Добавить возможность включать автоматический контроль за ограничениями на количество сообщений в секунду (очереди сообщений с балансировщиком), с минимальными задержками на отправку сообщений

Установка

1) Подключить клиент к проекту через Nuget (Gui менеджер или CLI). Подробнее тут.

ps:

   Install-Package DaData.ApiClient

Примечание:

Пакет требует следующие зависимости: -Newtonsoft.Json (nuget)

2) Получить API ключи (токены) на сайте сервиса

Использование:

//token - это Token из личного кабинета
//secret - это Secret из личного кабинета. Он нужен для некоторых методов

var client = new ApiClient(token, secret);

//Или

var client = new ApiClient(new ApiClientOptions()
{
    LimitQueries = Your Limit,
    Secret = Your Secret,
    Token = Your Token
});

//Пример вызова метода стандартизации адреса
var response = await client.StandartizationQueryAddress(new[]
{
    "address1",
    "address2"
}); 

//Или 

var response = await client.StandartizationQueryAddress(new AddressRequest()
{
    Queries = new List<string>()
    {
        "address1",
        "address2"
    }
});


//вернет модель 

//Аналогично происходят обращения и к другим методам API

Дополнительно:

Стоит заметить, что в проекте присутствуют интерфейсы для использования (и реализации) клиента(ов) со следующими наборами методов:

• Подсказок
• Стандартизации
• Дополнительными

Которые удобно использовать например для DI. Есть поддержка исключений, соответствующих кодам ошибок из документации

Для связи:

Писать на [email protected] или в телеграм @xambey.