Документация API / версия 1 / 8603032896-agreementsdkr

Документация API по работе с набором открытых данных


Идентификатор набора: 8603032896-agreementsdkr

Наименование набора: Договоры о комплексном развитии жилой застройки города Нижневартовска


С чего начать?

Для работы с API Вам потребуется уникальный ключ доступа. Чтобы получить его — пройдите несложную процедуру идентификации на портале.

Использование ключа доступа

API доступен только зарегистрированным разработчикам. Ключ доступа может передаваться любым из предложенных вариантов:
      в HTTP Header, в формате Authorization-Token: 'API_KEY:<ваш ключ>'.
      в GET-запросе, в формате ?api_key=<ваш ключ>.

Токен (api_key) можно посмотреть в профиле пользователя портала.



Для работы с набором открытых данных предусмотренны следующие API:


Значение
Формат
Адрес
Паспорт набора
JSON     HTML
/api/v1/8603032896-agreementsdkr/passport
Структура набора
JSON
/api/v1/8603032896-agreementsdkr/structure
Данные набора
JSON
/api/v1/8603032896-agreementsdkr/data[?param=value]


Паспорт набора

Паспорт набора - cовокупность сведений о наборе открытых данных, позволяющая однозначно идентифицировать такой набор и получить в автоматическом режиме ключевые параметры, характеризующие набор открытых данных.

Машиночитаемый паспорт открытых данных имеет структуру в формате JSON.

Запрос:
Ответ:
Загрузка...


Структура набора

Структура набора - совокупность сведений о полях набора открытых данных.

Машиночитаемая структура набора открытых данных имеет следующий вид:

Наименование поля
Тип данных
Значение поля
NUM
String
Порядковый номер
MO
String
ОМС МО, заключивший ИС
SID
String
Номер ИС
DAT
String
Дата заключения ИС
DESCRIPTION
String
Описание инвестиционного проекта, обязательства инвестора
YEAR
String
Срок действия ИС, лет
TITLE
String
Наименование и орг.-прав. форма стороны
ORG
String
Сфера реализации
ADDRESS
String
Место нахождения объекта ИС
INF
String
Сведения о товарах, работах, услугах
TYPE
String
Вид ИС
VOLUME_INV
String
Объем инвестиций, тыс. руб.
VOLUME_GOS
String
Объём гос. (муниципал.) поддержки, тыс. руб.
RESULTS_PLAN
String
Планируемые показатели результативности ИС
SUMM
String
Сумма налоговых отчислений, тыс. руб.
PDAT
String
Планируемая дата ввода созданного объекта
DOPINFO
String
Дополнительная информация по ИС
TEL
String
Контактное лицо (должность, телефон)

Запрос:
Ответ:
Загрузка...




Данные набора

Данные набора — систематизированная совокупность однотипных данных, представленных в форме открытых данных, состоящая из отдельных элементов, характеризующихся набором атрибутов, и позволяющая автоматизированным системам без участия человека идентифицировать, интерпретировать и обрабатывать такие элементы

Входящие параметры запроса API-Запроса имеет следующий вид:

Параметр
Тип данных
Значение
ROWS
Integer
Количество строк, содержащихся в ответе запроса (может использоваться для навигации по данным
PAGE
Integer
Номер страницы (может использоваться для навигации по данным)
Q
String
Поисковый фильтр, ограничивающий результаты запроса (полнотекстовый поиск по подстроке)

Пример API-запроса: https://data.n-vartovsk.ru/api/v1/8603032896-agreementsdkr/data?ROWS=2&PAGE=2





Ответ на запрос API-запрос

Структура ответа на API-запрос имеет следующий вид:

{
	"STATUS": CODE,
	"RESULT": - OBJECT,		
}
где
	CODE - Код ответа HTTP (200,400,403,404,500)
	OBJECT - Объект, имеющий следующую структуру:
	{
		"META" : {	 Мета информация, описывающая ответ
			"ROWS" : Integer		количество строк
			"PAGE" : Integer		номер страницы
			"ROWS_TOTAL" : Integer		общее количество строк, находящихся в ответе
			"PAGE_TOTAL" : Integer		общее количество страниц, находящихся в ответе
		},
		"ROWS" : [
			{ОБЪЕКТ}
		]
	}
	


Запрос:
Ответ:
Загрузка...