gem 'dadata', git: 'https://hub.mos.ru/ad/dadata'

bundle install

gem 'dadata', git: 'https://hub.mos.ru/ad/dadata', branch: 'v1.0.0'

rails generate dadata:initializer

rails generate dadata:initializer [опции]

Опции:
    --api-key=КЛЮЧ          # Ваш API-ключ DaData
    --secret-key=КЛЮЧ       # Ваш секретный ключ DaData
    --[no-]use-credentials  # Использовать ли Rails credentials (по умолчанию: true)
    --timeout=СЕКУНДЫ      # Таймаут запросов (по умолчанию: 3)
    --suggestions-count=N   # Количество подсказок (по умолчанию: 10)

Dadata.configure do |config|
  # API-ключ из личного кабинета
  config.api_key = 'ВАШ_API_КЛЮЧ'
  
  # Секретный ключ (для некоторых методов)
  config.secret_key = 'ВАШ_СЕКРЕТНЫЙ_КЛЮЧ'
  
  # Таймаут запросов в секундах
  config.timeout_sec = 3
  
  # Количество подсказок в ответе
  config.suggestions_count = 10

  # Размер пула соединений
  config.connection_pool_size = 25

  # Таймаут пула соединений
  config.connection_pool_timeout = 5

  # Уровень логирования (:debug, :info, :warn, :error)
  config.log_level = :info

  # Пользовательский логгер (опционально)
  config.logger = Logger.new('dadata.log')
end

I, [2025-01-25T20:44:10+03:00] INFO -- : DaData Request: POST https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/address
Headers: Authorization: [FILTERED], Content-Type: application/json

# Используя настройки из конфигурации
api = Dadata::Client.new

# Или с явным указанием ключей
api = Dadata::Client.new('ВАШ_API_КЛЮЧ', 'ВАШ_СЕКРЕТНЫЙ_КЛЮЧ')

suggest = Dadata::SuggestClient.new

# Поиск адреса
suggest.suggest("address", "москва хабар")

# Поиск организации
suggest.suggest("party", "сбербанк")

# Поиск банка по БИК или названию
suggest.suggest("bank", "044525225")

cleaner = Dadata::CleanClient.new

# Стандартизация адреса
cleaner.clean("address", "мск сухонская 11")

# Стандартизация ФИО
cleaner.clean("name", "иванов сергей")

# Стандартизация телефона
cleaner.clean("phone", "9161234567")

profile = Dadata::ProfileClient.new

# Проверка баланса
profile.balance

# Статистика использования
profile.daily_stats

result = api.clean("address", "мск сухонская 11")
puts result['result']      # Стандартизованный адрес
puts result['postal_code'] # Почтовый индекс
puts result['region']      # Регион
puts result['city']        # Город

result = api.suggest("party", "7707083893")
company = result[0]
puts company['value']    # Краткое название
puts company['inn']      # ИНН
puts company['address']  # Адрес

result = api.iplocate("46.226.227.20")
puts result['value']     # Город
puts result['region']    # Регион

Dadata::ApiError          # Ошибка API (неверный запрос)
Dadata::ConnectionError   # Ошибка соединения
Dadata::TimeoutError      # Превышен таймаут запроса

begin
  api.clean("address", "мск сухонская 11")
rescue Dadata::ApiError => e
  puts "Ошибка API: #{e.message}"
rescue Dadata::ConnectionError => e
  puts "Ошибка соединения: #{e.message}"
rescue Dadata::TimeoutError => e
  puts "Таймаут запроса: #{e.message}"
end

gem 'dadata', git: 'https://hub.mos.ru/ad/dadata'

bundle install

gem 'dadata', git: 'https://hub.mos.ru/ad/dadata', branch: 'v1.0.0'

rails generate dadata:initializer

rails generate dadata:initializer [options]

Options:
    --api-key=KEY           # Your DaData API key
    --secret-key=KEY        # Your DaData secret key
    --[no-]use-credentials  # Whether to use Rails credentials (default: true)
    --timeout=SECONDS       # Request timeout (default: 3)
    --suggestions-count=N   # Number of suggestions (default: 10)

Dadata.configure do |config|
  # API key from your account
  config.api_key = 'YOUR_API_KEY'
  
  # Secret key (required for some methods)
  config.secret_key = 'YOUR_SECRET_KEY'
  
  # Request timeout in seconds
  config.timeout_sec = 3
  
  # Number of suggestions in response
  config.suggestions_count = 10

  # Connection pool size
  config.connection_pool_size = 25

  # Connection pool timeout
  config.connection_pool_timeout = 5

  # Log level (:debug, :info, :warn, :error)
  config.log_level = :info

  # Custom logger (optional)
  config.logger = Logger.new('dadata.log')
end

I, [2025-01-25T20:44:10+03:00] INFO -- : DaData Request: POST https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/address
Headers: Authorization: [FILTERED], Content-Type: application/json

# Using configuration settings
api = Dadata::Client.new

# Or with explicit keys
api = Dadata::Client.new('YOUR_API_KEY', 'YOUR_SECRET_KEY')

suggest = Dadata::SuggestClient.new

# Address search
suggest.suggest("address", "moscow tverskaya")

# Organization search
suggest.suggest("party", "sberbank")

# Bank search by BIC or name
suggest.suggest("bank", "044525225")

cleaner = Dadata::CleanClient.new

# Address standardization
cleaner.clean("address", "msk suhonskaya 11")

# Name standardization
cleaner.clean("name", "ivanov sergey")

# Phone standardization
cleaner.clean("phone", "9161234567")

profile = Dadata::ProfileClient.new

# Check balance
profile.balance

# Usage statistics
profile.daily_stats

result = api.clean("address", "msk suhonskaya 11")
puts result['result']      # Standardized address
puts result['postal_code'] # Postal code
puts result['region']      # Region
puts result['city']        # City

result = api.suggest("party", "7707083893")
company = result[0]
puts company['value']    # Short name
puts company['inn']      # Tax ID
puts company['address']  # Address

result = api.iplocate("46.226.227.20")
puts result['value']     # City
puts result['region']    # Region

Dadata::ApiError          # API error (invalid request)
Dadata::ConnectionError   # Connection error
Dadata::TimeoutError      # Request timeout exceeded

begin
  api.clean("address", "msk suhonskaya 11")
rescue Dadata::ApiError => e
  puts "API Error: #{e.message}"
rescue Dadata::ConnectionError => e
  puts "Connection Error: #{e.message}"
rescue Dadata::TimeoutError => e
  puts "Request Timeout: #{e.message}"
end