Skip to content

alexchexes/dadata-sdk

 
 

Repository files navigation

Dadata SDK

Неофициальный набор инструментов для работы с API DaData.

Статус

Проект был начат в 2025 году, до публикации официальных OpenAPI-схем DaData. Пакеты всё также полезны на практике, но OpenAPI документация и часть контрактов требуют синхронизации с актуальным API. Если вы хотите помочь, откройте issue или PR.

Пакеты

  • packages/api-spec (@dadata-sdk/api-spec) - OpenAPI и JSON Schema, покрывающая практически весь публичный API ДаДаты.
  • packages/api-types (@dadata-sdk/api-types) - TypeScript-типы, константы и модели запросов/ответов для API DaData
  • packages/vue-dadata (@dadata-sdk/vue) - Vue 3.5+ компонент подсказок DaData
  • packages/schema-gen (@dadata-sdk/schema-gen) - инструмент для генерации JSON Schema из типов TypeScript (используя ts-json-schema-generator).

OpenAPI и JSON Schema

Готовые OpenAPI и JSON схемы лежат в packages/api-spec:

Просмотреть спецификацию можно здесь: https://alexchexes.github.io/dadata-sdk/ru/spec

Перечень всех API Дадаты, со ссылками к OpenAPI: https://alexchexes.github.io/dadata-sdk/ru/api/

TypeScript-типы

Пакет @dadata-sdk/api-types содержит TypeScript-контракты запросов и ответов всех публичных эндпоинтов API ДаДаты, а также константы.

Vue-компонент

@dadata-sdk/vue - компонент DaData-подсказок для Vue 3.5+. Поддерживает все основные suggest-эндпоинты, но наиболее широкая поддержка для адресов, организаций, банков. Компонент полностью типизирован. Доступен широкий набор слотов для точечной или полной кастомизации.

Vue 2 не поддерживается. Если нужен старый стек, посмотрите на ранние версии ikloster03/vue-dadata.

Благодарности

Отдельное спасибо этим проектам за идеи и базу, от которой можно было оттолкнуться:

Лицензия

MIT

DaData - товарный знак HFLabs.

About

Vue component for hinting addresses using dadata.ru (Vue 3.5+)

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 94.7%
  • Vue 3.4%
  • Other 1.9%