Описание
Это описание охватывает первую (бета) версию API в проекте Государственная сеть. Особенности использования API:
- все методы вызываются обращениями GET по определённым для них ссылкам
- форма ответа может быть CSV и JSON и для всех методов задаётся GET параметром format с соответствующими значениями json или csv.
Методы
ratings/w3c_badtop100 - список топ 100 худших веб-сайтов по результатам проверки через сервис W3C валидатор.
Доступен по ссылке:
http://www.govweb.ru/api/v1/ratings/w3c_badtop100/
Принимает параметр: format который может быть json или csv.
Например, при вызове
http://www.govweb.ru/api/v1/ratings/w3c_badtop100/?format=csv список который можно сохранить и открыть в Excel'е.
Структура колонок следующая:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4: website_name - название сайта
5. govbody_name - название госструктуры владельца сайта
6. w3c_weight - вес в рейтинге
7. w3c_position - позиция в рейтинге
8. w3c_v_errors - число ошибок валидатора
9. w3c_v_warnings - число предупреждений валидатора
10. w3c_v_probedate - дата проверки в формате ISO-8601
ratings/foreign - список сайтов на зарубежных хостингах
Доступен по ссылке:
http://www.govweb.ru/api/v1/ratings/foreign/
Принимает параметр: format который может быть json или csv Например, при вызове
http://www.govweb.ru/api/v1/ratings/foreign/?format=csv список который можно сохранить и открыть в Excel'е.
Структура колонок следующая:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. region - Регион (страна)
5: website_name - название сайта
6. govbody_name - название госструктуры владельца сайта
ratings/zone - список сайтов на вне доменной зоны .ru
Доступен по ссылке:
http://www.govweb.ru/api/v1/ratings/zone/
Принимает параметр: format который может быть json или csv.
Например, при вызове
http://www.govweb.ru/api/v1/ratings/zone/?format=csvсписок который можно сохранить и открыть в Excel'е.
Структура колонок следующая:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. domain - Домен
5. zone - Доменная зона
6: website_name - название сайта
7. govbody_name - название госструктуры владельца сайта
ratings/freehosting - список сайтов размещённых на бесплатных хостингах
Доступен по ссылке:
http://www.govweb.ru/api/v1/ratings/freehosting/
Принимает параметр: format который может быть json или csv.
Например, при вызове
http://www.govweb.ru/api/v1/ratings/freehosting/?format=csv список который можно сохранить и открыть в Excel'е.
Структура колонок следующая:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. domain - Домен
5: website_name - название сайта
6. govbody_name - название госструктуры владельца сайта
ratings/pdoms- список сайтов домены которых зарегистрированы на физических лиц
Доступен по ссылке:
http://www.govweb.ru/api/v1/ratings/pdoms/
Принимает параметр: format который может быть json или csv.
Например, при вызове
http://www.govweb.ru/api/v1/ratings/pdoms/?format=csv список который можно сохранить и открыть в Excel'е.
Структура колонок следующая:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. domain - Домен
5. owner_name - Имя владельца
6: website_name - название сайта
7. govbody_name - название госструктуры владельца сайта
ratings/cdoms - список сайтов домены которых зарегистрированы на юридических лиц
Доступен по ссылке:
http://www.govweb.ru/api/v1/ratings/cdoms/
Принимает параметр: format который может быть json или csv.
Например, при вызове
http://www.govweb.ru/api/v1/ratings/cdoms/?format=csv список который можно сохранить и открыть в Excel'е.
Структура колонок следующая:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. domain - Домен
5. zone - Доменная зона
6: website_name - название сайта
7. govbody_name - название госструктуры владельца сайта
common/siteinfo - подробная информация о сайте по его идентификатору
Принимает параметр:
id который является идентификатором сайта в системе.
Например,
http://www.govweb.ru/api/v1/common/siteinfo/?id=1 возвращает JSON со следующей структурой:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. domain - Домен
5: website_name - название сайта
6. govbody_name - название госструктуры владельца сайта
7.technologies - технологии на сайте в виде массива.
В виде структуры:
- key - уникальный идентификатор технологий
- name - название технологии
- category - категория к которой относится технология
common/checkhost- проверка на наличие сайта в каталоге по его доменному имени.
Принимает параметры:
-
hostname - доменное имя сайта для проверки
-
format (необязательный) может принимать значения csv и json.
Например,
http://www.govweb.ru/api/v1/common/checkhost/?hostname=fas.gov.ru&format=csv возвращает CSV со следующей структурой:
1: id - уникальный идентификатор сайта
2: uniq_url - уникальная ссылка в госсети
3: website_url - веб-адрес сайта
4. domain - Домен
5: website_name - название сайта
6. govbody_name - название госструктуры владельца сайта
Условия использования
Открытое API проекта Государственная Сеть может быть использовано для любых проектов при соблюдении следующего условия. На видном месте веб-страницы или приложения использующего API должен присутствовать текст: "Данные получены с использование API проекта Государственная сеть издания Полит.Ру" с активной гиперссылкой на сайт http://www.govweb.ru.ru по словам "Государственная сеть".