Открыли первую всероссийскую научно-практическую конференцию «Цифровая гуманитаристика: соединяя традиции и технологии» и заслушиваем выступающих с докладами на пленарном заседании ✨

#Бесплатный_кофе@digital_optimist

Знакомо чувство, когда программист говорит: «Подключу API, и данные сами подтянутся», а у вас ощущение, что он сейчас сказал что-то на эльфийском? На самом деле все не так страшно, и мы попробуем вас в этом убедить 😎

Представьте ресторан. Вы — клиент (ваша программа или ноутбук), а на кухне шеф-повар готов приготовить любое блюдо из меню (сервер, где хранится вся информация). Вам нужно конкретное блюдо — например, «все стихи Цветаевой в открытом доступе». Чтобы получить его вы не идёте на кухню сами, а подзываете официанта. Официант передаёт заказ на кухню, ждёт, пока приготовят, и приносит вам готовое блюдо. Этот официант и есть API. Он тоже не владеет точным рецептом блюда и не может его приготовить, но знает, как правильно обратиться к базе, оформить запрос и вернуть результат так, чтобы вы могли его легко съесть использовать. Вы не обязаны знать, как устроена кухня, чтобы получить блюдо из меню. API открывает доступ к огромным массивам данных, которые иначе пришлось бы собирать вручную ✏️

Вот несколько примеров, использования API, которые пригодятся любому гуманитарию:

🌿 Библиотеки и архивы. Хотите получить все оцифрованные документы по вашей теме из открытых коллекций Европейской библиотеки (например, Europeana)? У них есть API. Напишите запрос и получите список ссылок, метаданных, а иногда даже текстов

🌿 Анализ текстов. Нужно быстро обработать корпус из тысячи новостных заметок? Многие лингвистические сервисы (например, Google Cloud Natural Language) предоставляют API. Вы отправляете текст, а они возвращают анализ тональности, выделенные ключевые слова, сущности

🌿 Геоданные и карты. Хотите нанести на карту места рождения всех декабристов? API Яндекс.Карт позволяет это сделать без рисования маркеров вручную

🌿 Социальные сети. Если вам нужно собрать публичные посты по определённому хештегу за определенный период, то API соцсети — единственный легальный и структурированный способ

И вам даже не обязательно писать код. Можно пользоваться конструкторами и визуальными средами, в которые уже встроена работа с API. Например, Google Apps Script позволяет собирать данные из открытых API прямо в таблицы Google, выполняя запросы с помощью простых скриптов (готовых примеров полно в интернете)

Если API открытый (публичный) — любой разработчик может подключиться к сервису и использовать его данные или функции в своём приложении. Если закрытый — только для внутреннего использования

Где искать информацию об API на сайте? Обычно информацию о нем можно найти в «подвале» сайта (самый низ страницы) или в меню. Ключевые слова, на которые стоит обратить внимание: «API» (самое очевидное), «Developers» / «Для разработчиков», «Documentation» / «Docs» / «Документация», «Partners» / «Партнёрам», «Integrations» / «Интеграции». Если ничего не нашёл — гугли: «название сайта API». Если API существует, разработчики обычно пишут о нём публично

А вы когда-нибудь использовали API в своих исследованиях или хотя бы знали, что это возможно?
🔥 Да, я уже колдую — регулярно тяну данные через API
💀 Слышал, но не пробовал — боялся, что сложно
🤯 Не знал, что это нужно гуманитарию — спасибо, просветили!

#Ликбез@digital_optimist