В ссылках на все ресурсы API раздела "Открытые данные Республики Татарстан" должна содержаться информация об используемой версии в формате
https://opendata.tatar.ru/api/{version}. Номер текущей версии можно узнать при помощи запроса, указанного ниже.
Запрос:
https://opendata.tatar.ru/api
Ответ:
{
"version":"v1"
}
Метод возвращаетJSONмассив идентификаторов пакетов данных, которые могут быть использованы в запросе на получение метаданных пакета. Ограничение количества результатов возможно при помощи GET-параметровoffsetиlimitПри отсутствии данных параметров, возвращается массив всех пакетов.
Запрос:
https://opendata.tatar.ru/api/v1/package?limit=3
Ответ:
[
"005e2bc4bc2996c5f54c3783363f9e4b",
"00a0cd2fdf6134c3000b247d97df2d60",
"025bcf3ccee53cf72006e282203dcfb2"
]
Метод возвращает метаданные пакета, а также перечень входящих в него наборов данных.
Запрос:
https://opendata.tatar.ru/api/v1/package/00a0cd2fdf6134c3000b247d97df2d60
Ответ:
{
"maintainer": "Управление по охране и использованию объектов животного мира Республики Татарстан",
"metadata_created": "2014-09-05T12:52:14.465572",
"author": "Гайнутдинова Разиля Адгамовна",
"resources": [
{
"id": "5c89333f-becc-414d-81e4-a02ce36ef984",
"format": "CSV",
"name": "Информация о добыче птиц c 2013-01-01 по 2013-12-31",
"created": "2014-09-05T17:01:25.835226",
"size": "818 байт"
}
],
"organization": "Управление по охране и использованию объектов животного мира Республики Татарстан",
"title": "Информация о добыче птиц",
"periodicity": "Ежегодно"
}
author- Ответственный за данные
metadata_created- Дата создания пакета
resources- Массив наборов данных
organization- Ответственная организация
title- Название пакета
periodicity- Периодичность обновления данных в пакете
Возвращает массив всех доступных категорий
Запрос:
https://opendata.tatar.ru/api/v1/category
Ответ:
["Адреса и контакты", "Государственный заказ", "Демография", ...]
Метод возвращает JSON массив идентификаторов пакетов с наборами данных. Эти идентификаторы могут быть использованы в методе получения метаданных пакета.
Запрос:
https://opendata.tatar.ru/api/v1/category/Демография
Ответ:
[
"0c04c26d082d81a22761911eaef00fbb",
"101d4f507493a86dbb959c0ae668d9bf",
"155e803db498af53de670343bcb5f6b0"
]
Строка, по которой необходимо осуществить поиск, передается в GET-параметре query
Запрос:
https://opendata.tatar.ru/api/v1/search?query=товаров
Ответ:
[
{
"maintainer": "Татарстанстат",
"metadata_created": "2015-01-31T20:02:54.307092",
"author": "",
"resources": [
{
"id": "f8175136-d48a-4f93-9314-f9c45f467ec6",
"format": "CSV",
"name": "Динамика цен на продовольственные товары по регионам ПФО c 2015-01-19 по 2015-01-25",
"created": "2015-01-31T23:04:37.948554",
"size": "5.79 КБ"
},
{
"id": "03e21df6-27ed-4303-a0fb-36c3188009ca",
"format": "CSV",
"name": "Динамика цен на продовольственные товары по регионам ПФО c 2015-01-26 по 2015-02-01",
"created": "2015-02-07T23:05:04.778312",
"size": "4.65 КБ"
}
],
"organization": "Татарстанстат",
"title": "Динамика цен на продовольственные товары по регионам ПФО",
"periodicity": "Еженедельно"
},
{
"maintainer": "Татарстанстат",
"metadata_created": "2015-01-31T20:02:43.229771",
"author": "",
"resources": [
{
"id": "8c704be2-c917-4e43-b4bf-3bc2bac48c70",
"format": "CSV",
"name": "Динамика средних потребительских цен на хлеб и булочные изделия из пшеничной муки 1 сорта по регионам Приволжского федерального округа, руб. c 2015-01-19 по 2015-01-25",
"created": "2015-01-31T23:04:27.452134",
"size": "653 байт"
},
{
"id": "e2f0b363-c8b0-486a-a114-10bbd278437e",
"format": "CSV",
"name": "Динамика средних потребительских цен на хлеб и булочные изделия из пшеничной муки 1 сорта по регионам Приволжского федерального округа, руб. c 2015-01-26 по 2015-02-01",
"created": "2015-02-07T23:04:54.616101",
"size": "994 байт"
}
],
"organization": "Татарстанстат",
"title": "Динамика средних потребительских цен на хлеб и булочные изделия из пшеничной муки 1 сорта по регионам Приволжского федерального округа, руб.",
"periodicity": "Еженедельно"
},
{
"maintainer": "Татарстанстат",
"metadata_created": "2015-01-31T20:02:34.285161",
"author": "",
"resources": [
{
"id": "67b2fb42-fe14-4ebd-aaf3-4acd4521bb82",
"format": "CSV",
"name": "Динамика средних потребительских цен на хлеб ржаной и ржано-пшеничный по регионам Приволжского федерального округа, руб. c 2015-01-19 по 2015-01-25",
"created": "2015-01-31T23:04:18.370342",
"size": "609 байт"
},
{
"id": "2e822650-a06b-4ee0-8a26-3c456db546ba",
"format": "CSV",
"name": "Динамика средних потребительских цен на хлеб ржаной и ржано-пшеничный по регионам Приволжского федерального округа, руб. c 2015-01-26 по 2015-02-01",
"created": "2015-02-07T23:04:45.191773",
"size": "949 байт"
}
],
"organization": "Татарстанстат",
"title": "Динамика средних потребительских цен на хлеб ржаной и ржано-пшеничный по регионам Приволжского федерального округа, руб.",
"periodicity": "Еженедельно"
}
]
Метод возвращает содержимое набора данных по его идентификатору. Ограничение количества результатов осуществляется при помощи GET-параметровoffsetиlimitПри отсутствии данных параметров, возвращаются все данные из набора.
Запрос:
https://opendata.tatar.ru/api/v1/resource/a7ba63c5-7f74-4d94-ab6c-f1c0396f366c?limit=5&offset=5
Ответ:
{
"resource_id": "a7ba63c5-7f74-4d94-ab6c-f1c0396f366c",
"fields": [
{
"type": "int4",
"id": "_id"
},
{
"type": "text",
"id": "title"
},
{
"type": "text",
"id": "1. Средняя розничная цена на катык до 2,5% жирности (руб/кг)"
}
],
"records": [
{
"_id": 6,
"1. Средняя розничная цена на катык до 2,5% жирности (руб/кг)": "35.5",
"title": "Актанышский район"
},
{
"_id": 7,
"1. Средняя розничная цена на катык до 2,5% жирности (руб/кг)": "49.24",
"title": "Алексеевский район"
},
{
"_id": 8,
"1. Средняя розничная цена на катык до 2,5% жирности (руб/кг)": "43.45",
"title": "Алькеевский район"
},
{
"_id": 9,
"1. Средняя розничная цена на катык до 2,5% жирности (руб/кг)": "47.96",
"title": "Альметьевский район"
},
{
"_id": 10,
"1. Средняя розничная цена на катык до 2,5% жирности (руб/кг)": "42.9",
"title": "Апастовский район"
}
],
"offset": 5,
"limit": 5,
"total": 45
}
Ключrecordsсодержит массив данных для данного набора, ключfieldsсодержит набор всех полей с данными.