Что?Data — набор API и инструментов для обработки данных. Каждый инструмент оформлен как отдельный модуль; ниже перечислены доступные. Сейчас основной модуль — очистка телефонов.
Очистка и разбор телефонных номеров из произвольной строки. Российские номера обогащаются данными реестра Минцифры (оператор, регион, город), зарубежные — встроенными базами phonenumbers.
POST/api/v1/clean/phone
Тело запроса — JSON-массив строк. Ответ — JSON-массив объектов в том же порядке.
Авторизация не требуется. Формат ответа совместим с DaData.
Записей в реестре Минцифры: 445 953
curl -X POST https://chtodata.ru/api/v1/clean/phone \
-H "Content-Type: application/json" \
-d '["раб 846)231.60.14 *139"]'
[
{
"source": "раб 846)231.60.14 *139",
"type": "Стационарный",
"phone": "+7 846 231-60-14 доб. 139",
"country_code": "7",
"city_code": "846",
"number": "2316014",
"extension": "139",
"provider": "ООО \"СИПАУТНЭТ\"",
"country": "Россия",
"country_iso": "ru",
"region": "Самарская область",
"city": "Самара",
"timezone": "UTC+4",
"qc_conflict": 0,
"qc": 0
}
]
| Поле | Описание |
|---|---|
source | Исходная строка, как пришла на вход. |
type | Тип номера: «Мобильный», «Стационарный», «Бесплатный» и т.п. |
phone | Нормализованный номер, напр. +7 846 231-60-14 доб. 139. |
country_code | Код страны, напр. 7. |
city_code | Код города / DEF-код, напр. 846. |
number | Локальный номер без кода города. |
extension | Добавочный номер (если есть). |
provider | Оператор связи (из реестра Минцифры). |
country | Страна, напр. «Россия», «Казахстан», «Соединенные Штаты». |
country_iso | Двухбуквенный код страны ISO 3166-1, напр. ru, us, kz. |
region | Регион / субъект РФ (для зарубежных номеров пусто). |
city | Город / населённый пункт. |
timezone | Часовой пояс, напр. UTC+4. |
qc_conflict | Код конфликта данных (всегда 0 в текущей версии). |
qc | Код качества разбора (см. ниже). |
| Код | Значение |
|---|---|
0 | Телефон распознан. |
1 | Телефон не распознан (пустая строка или непохоже на номер). |
| Метод и путь | Назначение |
|---|---|
GET /api/health | Состояние сервиса и модулей (число записей, дата обновления базы). |
POST /api/admin/refresh | Ручное обновление базы Минцифры (требует токен; по умолчанию отключено). |
GET /swagger | Интерактивная OpenAPI-документация. |
База операторов и регионов формируется из открытых данных Минцифры (opendata.digital.gov.ru) и обновляется автоматически. Значения региона, города и часового пояса — приближённые: формат ответа совпадает с DaData, но значения берутся из реестра Минцифры и могут немного отличаться.