OVD-Info · Legacy V1 API repression.net

Обзор

Тот же контракт (роуты, форма ответа, названия полей), что был у старого сервиса, ранее отдававшегося с repression.net/en/api — для существующих интеграций, которые уже написаны под него. Это старый API: новые возможности (карточка персоны с адресом для писем и «Весточкой», уголовные дела, реестры, оценки правозащитников, хронология событий одним ответом) в него не добавляются — они выходят только в Public API (датасет profiles). Для новых интеграций используйте его.

Базовый путь: http://api.repressions.org/v1

Аутентификация

Как и у Public API — заголовок X-API-Key на каждый запрос. У старого сервиса ключа не было вообще; это единственное намеренное отличие от исходного поведения.

Исключение — ссылки на фото (person_photo/photo): это готовые публичные URL вида /v1/persons/{id}/photo/{photo_id}, рассчитанные на прямую вставку в <img src> на сторонних страницах, поэтому ключа не требуют.

Две формы данных

Плоская (flat) — одна строка на преследование, все связанные данные (статьи, приговор, меры пресечения) уже развёрнуты в поля текущей строки. Отдаётся через GET /v1/data.

Объектная (objective) — граф из 11 связанных сущностей с references между ними, так же, как в исходном сервисе. Отдаётся через GET /v1/{коллекция} и связанные роуты ниже.

Сущности

Эндпоинты

Query-параметры

Важно про subset: это не накопительный уровень, а точная принадлежность — поле показывается, только если запрошенный subset буквально есть в его собственном списке subset'ов. Поле, помеченное только как full, не появится при ?subset=detailed, хотя интуитивно могло бы. Полный список subset'ов каждого поля — в GET /v1/schema.

Presets (?preset=, только /v1/data)

Примеры

# Схема плоской формы на английском
curl "http://api.repressions.org/v1/schema?type=flat&language=en" \
  -H "X-API-Key: <ваш_ключ>"

# Плоский список: активные преследования женщин, отсортированные по дате начала
curl "http://api.repressions.org/v1/data?preset=actual&filter={\"gender_ru\":\"Женский\"}&sortBy=persecution_started&order=desc" \
  -H "X-API-Key: <ваш_ключ>"

# То же самое — сразу файлом CSV
curl "http://api.repressions.org/v1/data?preset=actual&csv=true" \
  -H "X-API-Key: <ваш_ключ>" -o persecutions.csv

# Персона с разворотом всех связей (дело, статьи, меры пресечения…)
curl "http://api.repressions.org/v1/persons/<uuid>?subset=full" \
  -H "X-API-Key: <ваш_ключ>"

# Только связанные уголовные дела этой персоны, с полными атрибутами
curl "http://api.repressions.org/v1/persons/<uuid>/references/cases?subset=full&references=ru" \
  -H "X-API-Key: <ваш_ключ>"

# Фото — обычная публичная ссылка, ключ не нужен
<img src="http://api.repressions.org/v1/persons/<uuid>/photo/<photoId>">

Отличия от исходного API

Большинство полей воспроизведены как есть, часть — доисследована и досчитана заново (переводы на английский, слаг персоны, ссылка для переписки, тематические группы дел, изоляция в колонии, суть приговора и адрес учреждения на английском и т.п. — последние два были реальным текстом в старой базе, который просто не попал в Postgres при миграции, и теперь догружены отдельным скриптом). Известные пробелы: