...

суббота, 9 ноября 2013 г.

API для Российской общественной инициативы. Шаг 2.2: опыт США в работе с данными электронных петиций — API Белого Дома

Ранее я писал в паре постов постав о том как устроена открытость электронных петиций в разных странах, какие данные есть в России и как можно сделать APO для небезызвестной Российской общественной инциативы — www.roi.ru.

Прочитать всё это можно здесь:


В этот раз мы рассмотрим то как устроены электронные петиции Белого Дома, в первую очередь, с точки зрения их открытости и пригодности к данных для использования.



Справка




Особенности петиций в США




  1. Относятся именно к президенту и ответы дает его администрация.

  2. Не требуют ничего кроме email'а для подписи — дополнительная авторизация ненужна.

  3. Петиции должны пройти 2 порога — 150 подписей за 30 дней чтобы их можно было найти (по прямой ссылке они доступны) и 100 000 подписей за 30 дней чтобы получить официальный ответ — petitions.whitehouse.gov/how-why/terms-participation




В цифрах




  • всего 2246 петиций

  • даны ответы на 208 петиций

  • в ожидании ответа 26 петиций

  • закрыто 1972 петиций

  • открыто для голосования 40 петиций




Цифры учитывают только те петиции что прошли 1-й порог в 150 подписей за 30 дней.

WhiteHouse.gov/developers


Одно из важных отличий сайта Белого Дома США от сайтов всех лидеров в мире — это ориентированность на разработчиков. На сайте даже есть специальный раздел /Developers где размещены данные, раскрыт исходный код проектов и описаны API многих из инициатив если не всех вообще.


Открытый код

Поскольку нас интересуют в первую очередь петиции, то рассмотрим их подробнее.


Во первых исходный код петиций полностью опубликован на Github — https://github.com/WhiteHouse/petitions


У репозитория больше 15 контрибьюторов, несколько десятков багов и вопросов и мы можем говорить о том что разработка проекта идет открытым образом.


Открытое API



Другая сторона происходящего в том для разработчиков доступен не только исходный код, но и API и данные накопленные на сервисе.

Все API по петициям доступны по ссылке — https://petitions.whitehouse.gov/developers

API доступа к данным состоит из 3-х эндпоинтов:



  • GET /v1/petitions

  • GET /v1/petitions/{petition_id}

  • GET /v1/petitions/{petition_id}/signatures


Список петиций и выборки петиций (GET /v1/petitions)

Возвращает список петиций, отдельные петиции и подписи к отдельным петициям. Не поддерживает нелатинские символы и содержит ограничение в не более чем 10 запросов в секунду.


В описании API заложена фильтрация по: ссылке, статусу, числу подписавших и многому другому.

Подробнее — petitions.whitehouse.gov/developers#petitions-index


Карточка петиции (GET /v1/{petition_id})

Возвращает подробное описание отдельной петиции включая дату её создания, название, текст, статус, дедлайн, темы, число подписавших.


Подробнее — petitions.whitehouse.gov/developers#petitions-retrieve


Список подписантов (GET /v1/{petition_id}/signatures)



И, наконец, по каждой петиции есть возможность получить список всех, или выборку по фильтрам, подписавших петицию без их полных ФИО, но с геокодом в виде почтового индекса и точными датой и временем подписи.

Вот как выглядит элемент массива подписи при ответе этого метода:



"0": {
"id": "5017a5ca6889385944000000",
"type": "signature",
"name": "DP",
"zip": "94530",
"created": 1343727050
},


Подробнее — petitions.whitehouse.gov/developers#petitions-signatures


Особенно интересно последнее — возможность получить информации по каждому голосу даёт многое — немало разработчиков в США используют это для мониторинга активности подписей петиций.


Открытые данные



Но и это еще не все. Для тех кому не так важно получать данные в реальном времени, но важно иметь базу для анализа разработчики дают данные для массовой выгрузки. По ссылке https://api.whitehouse.gov/v1/downloads/data.sql.zip

файл архива адампа в SQL на 200 мегабайт.

Это к вопросу о том что когда есть желание сделать что-то открытым, то возникают не оговорки про то как это сложно, а быстро делается хотя бы таким самым простым образом.


Экосистема


Все вышеперечисленное было бы не так интересно если бы на примере открытия данных о петициях в Белом доме не появилось бы множество проектов использующих эту информацию. Проект изначально сделанный разработчиками для разработчиков очень быстро стал пользоваться популярностью у тех кто создавал экосистему вокруг.


На самом Белом доме есть раздел под названием API Gallery где я насчитал не менее 18 приложений.


Вот лишь неполный список:


Петиции это далеко не все




Петиции — это, хотя и важно, но далеко не единственное что государство должно открывать для всех. API для петиций — это лишь малая часть всех API открытых ведомствами США за последние несколько лет. Вот тут можно посмотреть гораздо больше всего — gsa.github.io/slash-developer-pages/, а активисты давно уже создают проект / the united states собрав ключевые API в одном месте

В качестве послесловия. Главное отличие опыта США в работе с петициями — заведомая технологическая прозрачность и построение экосистемы. Кооперация с независимыми разработчиками позволяет привлекать к петициям гораздо большее внимание и использовать технические инструменты для продвижения инициатив.


This entry passed through the Full-Text RSS service — if this is your content and you're reading it on someone else's site, please read the FAQ at fivefilters.org/content-only/faq.php#publishers. Five Filters recommends:



Комментариев нет:

Отправить комментарий