Поиск ОПФ
Общие сведения
Данный справочник содержит перечень видов организационно-правовых форм (ОПФ).
Поиск ОПФ
Запрос метода
Структура запроса
Адрес метода: https://api.dellin.ru/v1/references/opf_list.json
{ "appkey":"00000000-0000-0000-0000-000000000000", "title":"Отк", "name":"ОАО", "countryUID":"0x8f51001438c4d49511dbd774581edb7a" }
Адрес метода: https://api.dellin.ru/v1/references/opf_list.xml
<request> <appkey>00000000-0000-0000-0000-000000000000</appkey> <title>Отк</title> <name>ОАО</name> <countryUID>0x8f51001438c4d49511dbd774581edb7a</countryUID> </request>
Описание параметров
Request | |||
---|---|---|---|
Параметр | Обязательный | Тип | Описание |
appkey | Да | string | Ключ приложения. Для получения ключа необходимо пройти регистрацию |
title | Нет* | string | Полное название ОПФ или его часть. Минимальная длина строки - 3 символа. Поиск осуществляется как по началу, так и по середине строки. *Запрос может содержать только один из параметров: "title" или "name" |
name | Нет* | string | Краткое наименование ОПФ (ООО, ОАО и т. п.). Поиск осуществляется с начала строки, точное совпадение обязательно *Запрос может содержать только один из параметров: "title" или "name" |
countryUID | Нет | string | UID страны, см. "Поиск стран" |
Ответ метода
Структура ответа
{ "metadata":{ "status":200, "generated_at":"2015-06-18 12:37:28" }, "data":[ { "uid":"0x8390b2048d37e0154b845fb22793e865", "name":"ОАО", "juridical":"true", "title":"Открытое Акционерное Общество", "innLength":10, "countryUID":"0x8f51001438c4d49511dbd774581edb7a" } ] }
<response> <metadata> <status>200</status> <generated_at>2015-06-18 12:37:28</generated_at> </metadata> <data> <uid>0x8390b2048d37e0154b845fb22793e865</uid> <name>ОАО</name> <juridical>true</juridical> <title>Открытое Акционерное Общество</title> <innLength>10</innLength> <countryUID>0x8f51001438c4d49511dbd774581edb7a</countryUID> </data> </response>
Описание параметров
Response | ||
---|---|---|
Параметр | Тип | Описание |
metadata | object | Системная информация |
metadata.status | integer | Эмуляция http-кода состояния. В случае успешного выполнения возвращается код "200" |
metadata.generated_at | string | Дата и время генерации ответа сервера. Формат: "ГГГГ-ММ-ДД ЧЧ:ММ:СС" |
data | array of Data | Информация об ОПФ |
data.uid | string | UID ОПФ |
data.name | string | Краткое наименование ОПФ (ООО, ОАО и т. п.) |
data.juridical | boolean | Флаг обозначающий, что ОПФ является юридическим лицом |
data.title | string | Полное наименование ОПФ |
data.innLength | integer | Необходимое количество цифр в ИНН |
data.countryUID | string | UID страны, см. "Поиск стран" |
Обработка ошибок
В методе используются общие ошибки API, описание формата и перечень ошибок см. в документе "Ошибки методов API".