- Создатель Никита Таныгин, отредактировано 29 янв. 2016
Вы просматриваете старую версию данной страницы. Смотрите текущую версию.
Сравнить с текущим просмотр истории страницы
« Предыдущий Версия 4 Следующий »
Запрос
Для пользователей бесплатных подсказок DaData.ru:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "альфа" }' \ https://dadata.ru/api/v2/suggest/bank
Для пользователей платных подсказок DaData.ru:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "альфа" }' \ http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/bank
Для пользователей standalone-подсказок:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "query": "альфа" }' \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/bank
Параметры
Параметр | Обязательный? | Описание |
---|---|---|
query | да | Запрос, для которого нужно получить подсказки |
count | нет | Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20). |
status | нет | Ограничение по статусу организации |
type | нет | Ограничение по типу организации |
Ответ
Возвращается список объектов банка:
Поле | Тип данных | Описание |
---|---|---|
value | string(1000) | Для банков ( Для всех остальных: платежное наименование ( |
unrestricted_value | string(1000) | = value |
data.bic | string(10) | БИК |
data.swift | string(20) | SWIFT |
data.inn | string(20) | ИНН (начиная с версии 20.3) |
data.kpp | string(10) | КПП (начиная с версии 20.3) |
data.correspondent_account | string(20) | Корреспондентский счет |
data.treasury_accounts[] | string[](20) | Казначейские счета территориального ОФК (21.2+) |
data.registration_number | string(10) | Регистрационный номер |
data.name └ payment └ full └ short | string(200) string(1000) | Наименование: — платежное — не заполняется — краткое |
data.payment_city | string(50) | Город для платежного поручения (поля справочника Tnp + Nnp) (начиная с версии 19.7) |
data.opf | Тип кредитной организации | |
└ type | string(50) | Код типа
|
└ full | не заполняется | |
└ short | не заполняется | |
data.cbr | object | Управление Банка России, к которому относится банк. Заполняется только при вызове через метод API findById (21.2+) В поле возвращается Объект банка без заполнения гранулярных полей адреса. |
data.address | Адрес регистрации | |
└ value | string(1000) | — адрес банка одной строкой (краткий) Стандартизован, поэтому может отличаться от записанного в справочнике БИК. |
└ unrestricted_value | string(1000) | — адрес банка одной строкой (полный) |
└ data | ||
└ data.source | string(1000) | — адрес одной строкой как в справочнике БИК |
└ data.qc | string(10) | — код качества адреса (начиная с версии 19.1)
|
data.state | Состояние | |
└ actuality_date | long | — дата актуальности сведений |
└ registration_date | long | — дата регистрации |
└ liquidation_date | long | — дата ликвидации |
└ status | string(50) | — статус
Статус LIQUIDATED в реальных данных не встречается, потому что Банк России не возвращает информацию о ликвидированных финансовых организациях. |
data.okpo | не заполняется | |
data.phone | не заполняется | |
data.rkc | не заполняется |
Формат даты
Даты регистрации и ликвидации — количество миллисекунд от 01.01.1970. Хранится в UTC.
Для JavaScript преобразуется в дату так:
var ticks = 989784000000, date = new Date(ticks);
Для PHP:
$ticks = 989784000000; $sec = $ticks / 1000; echo date("d.m.Y", $sec);
Для Java:
long ticks = 989784000000; Calendar cal = Calendar.getInstance(); cal.setTimeInMillis(ticks);
Для C#:
long ticks = 989784000000; DateTime date = new DateTime(long.Parse(ticks));
Примеры
Запрос:
{ "query": "альфа" }
Ответ:
{ "suggestions": [ { "value": "АЛЬФА-БАНК", "unrestricted_value": "АЛЬФА-БАНК", "data": { "opf": { "type": "BANK", "full": "Банк", "short": "Б" }, "name": { "payment": "АО \"АЛЬФА-БАНК\"", "full": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"АЛЬФА-БАНК\"", "short": "АЛЬФА-БАНК" }, "bic": "044525593", "swift": "ALFARUMMXXX", "okpo": "09610444", "correspondent_account": "30101810200000000593", "registration_number": "1326", "rkc": { "opf": { "type": "RKC", "full": "Главное управление/Отделение (НБ)", "short": "ГУ/О" }, "name": { "payment": "ГУ БАНКА РОССИИ ПО ЦФО", "full": null, "short": null }, "bic": "044525000", "swift": null, "okpo": "09201220", "correspondent_account": null, "registration_number": null, "rkc": null, "address": { "value": "115035, МОСКВА 35, УЛ.БАЛЧУГ,2", "unrestricted_value": "115035, МОСКВА 35, УЛ.БАЛЧУГ,2", "data": null }, "phone": null, "state": { "status": "ACTIVE", "actuality_date": 1453939200000, "registration_date": 889488000000, "liquidation_date": null } }, "address": { "value": "г Москва, ул Каланчевская, д 27", "unrestricted_value": "г Москва, ул Каланчевская, д 27", "data": { "qc_complete": null, "qc_house": null, "qc_geo": "0", "postal_code": "107078", "postal_box": null, "country": "Россия", "region_with_type": "г Москва", "region_type": "г", "region_type_full": "город", "region": "Москва", "area_with_type": null, "area_type": null, "area_type_full": null, "area": null, "city_with_type": "г Москва", "city_type": "г", "city_type_full": "город", "city": "Москва", "city_district": "Красносельский р-н", "settlement_with_type": null, "settlement_type": null, "settlement_type_full": null, "settlement": null, "street_with_type": "ул Каланчевская", "street_type": "ул", "street_type_full": "улица", "street": "Каланчевская", "house_type": "д", "house_type_full": "дом", "house": "27", "block_type": null, "block_type_full": null, "block": null, "flat_area": null, "square_meter_price": null, "flat_price": null, "flat_type": null, "flat_type_full": null, "flat": null, "fias_id": "b587ebb8-2892-4826-ab85-42dc1523ba73", "fias_level": "8", "kladr_id": "7700000000006360032", "tax_office": "7708", "tax_office_legal": null, "capital_marker": "0", "okato": "45286565000", "oktmo": "45378000", "timezone": null, "geo_lat": "55.7749202", "geo_lon": "37.6503634", "beltway_hit": null, "beltway_distance": null, "unparsed_parts": null, "qc": null } }, "phone": null, "state": { "status": "ACTIVE", "actuality_date": 1453939200000, "registration_date": 759024000000, "liquidation_date": null } } } ] }
Запрос:
<req> <query>втб 24</query> </req>
Ответ:
<SuggestResponse> <suggestions> <value>ВТБ 24 (ПАО)</value> <unrestricted_value>ВТБ 24 (ПАО)</unrestricted_value> <data> <opf> <type>BANK</type> <full>Банк</full> <short>Б</short> </opf> <name> <payment>ВТБ 24 (ПАО)</payment> <full>БАНК ВТБ 24 (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)</full> <short>ВТБ 24 (ПАО)</short> </name> <bic>044525716</bic> <swift>CBGURUMMXXX</swift> <okpo>20606880</okpo> <correspondent_account>30101810100000000716</correspondent_account> <registration_number>1623</registration_number> <rkc> <opf> <type>RKC</type> <full>Главное управление/Отделение (НБ)</full> <short>ГУ/О</short> </opf> <name> <payment>ГУ БАНКА РОССИИ ПО ЦФО</payment> <full/> <short/> </name> <bic>044525000</bic> <swift/> <okpo>09201220</okpo> <correspondent_account/> <registration_number/> <rkc/> <address> <value>115035, МОСКВА 35, УЛ.БАЛЧУГ,2</value> <unrestricted_value>115035, МОСКВА 35, УЛ.БАЛЧУГ,2</unrestricted_value> <data/> </address> <phone/> <state> <status>ACTIVE</status> <actuality_date>1453939200000</actuality_date> <registration_date>889488000000</registration_date> <liquidation_date/> </state> </rkc> <address> <value>г Москва, ул Мясницкая, д 35</value> <unrestricted_value>г Москва, ул Мясницкая, д 35</unrestricted_value> <data> <qc_complete/> <qc_house/> <qc_geo>0</qc_geo> <postal_code>101000</postal_code> <postal_box/> <country>Россия</country> <region_with_type>г Москва</region_with_type> <region_type>г</region_type> <region_type_full>город</region_type_full> <region>Москва</region> <area_with_type/> <area_type/> <area_type_full/> <area/> <city_with_type>г Москва</city_with_type> <city_type>г</city_type> <city_type_full>город</city_type_full> <city>Москва</city> <city_district>Красносельский р-н</city_district> <settlement_with_type/> <settlement_type/> <settlement_type_full/> <settlement/> <street_with_type>ул Мясницкая</street_with_type> <street_type>ул</street_type> <street_type_full>улица</street_type_full> <street>Мясницкая</street> <house_type>д</house_type> <house_type_full>дом</house_type_full> <house>35</house> <block_type/> <block_type_full/> <block/> <flat_area/> <square_meter_price/> <flat_price/> <flat_type/> <flat_type_full/> <flat/> <fias_id>51add53a-90b9-4934-a6e0-a23ba9ba5c95</fias_id> <fias_level>8</fias_level> <kladr_id>7700000000071190111</kladr_id> <tax_office>7708</tax_office> <tax_office_legal/> <capital_marker>0</capital_marker> <okato>45286565000</okato> <oktmo>45378000</oktmo> <timezone/> <geo_lat>55.7657887</geo_lat> <geo_lon>37.6386041</geo_lon> <beltway_hit/> <beltway_distance/> <unparsed_parts/> <qc/> </data> </address> <phone/> <state> <status>ACTIVE</status> <actuality_date>1453939200000</actuality_date> <registration_date>759024000000</registration_date> <liquidation_date/> </state> </data> </suggestions> </SuggestResponse>
- Нет меток