Scryfall

Scryfall — это веб-база данных и поисковая система для карт Magic: The Gathering, коллекционной карточной игры, издаваемой Wizards of the Coast. На страницах карт собраны текст Oracle, издания, легальность, разъяснения, цены, указание художников, номера коллекционеров, варианты отделки, языки, сведения о выпусках и изображения карт в высоком разрешении. Сервис идентифицирует отдельные издания с помощью стабильных идентификаторов в стиле UUID и представляет карты через документированный публичный API. Важное различие в Scryfall проводится между объектом карты и изданием. Поиск по названию карты может показать множество редакций, а параметр поиска "unique" позволяет управлять тем, группируются ли результаты по картам, иллюстрациям или изданиям. Синтаксис поддерживает запросы по конкретным полям, например `t:dragon`, `c:rw`, `o:flying` и `set:lea`, а также сравнения по мана-стоимости, силе, выносливости, датам, ценам и другим атрибутам. Операторы поиска включают логические выражения, отрицание, регулярные выражения для выбранных полей и скобки. Сайт также предлагает поддерживаемые теггерами теги иллюстраций и пользовательские поиски, такие как "Random Card" и "Tagger". Scryfall тщательно фиксирует детали Magic, относящиеся к правилам. Он предоставляет актуальную формулировку Oracle, используемую для функционального текста карт, цветовую идентичность, мана-стоимость, строку типа, ключевые слова, все части объектов из нескольких карт и легальность в форматах. Данные разъяснений связаны с отдельными картами и включают даты публикации и комментарии к разъяснениям. Сервис различает трансформируемые карты, модальные двухсторонние карты, разделённые карты, карты слияния, жетоны, эмблемы и другие макеты, не соответствующие простой модели односторонней карты. Разработчики могут использовать REST API Scryfall без учётной записи для поиска карт, автодополнения, значений каталогов, выпусков, разъяснений, символов и поиска. Ответы API включают URI изображений, когда они доступны, URI покупок, ссылки на связанные карты и метаданные пагинации. Scryfall также публикует загружаемые файлы массовых данных, включая карты по умолчанию, все карты, карты Oracle, уникальные иллюстрации и разъяснения. Эти файлы предназначены для офлайн-обработки и периодически обновляются; конечная точка массовых данных сообщает временные метки обновления и ссылки для скачивания. База данных охватывает официально выпущенные карты Magic и многие связанные игровые объекты; на страницах выпусков указаны даты выхода, коды выпусков, общее число карт, цифровой статус и иконография. Она особенно полезна для отслеживания одного и того же игрового компонента среди переизданий, промо-карт, релизов Secret Lair, продуктов Commander, выпусков Masters и релизов, доступных только в цифровом виде. В документации Scryfall пользователей просят соблюдать ограничения частоты запросов, кэшировать результаты и указывать описательный User-Agent при выполнении API-запросов. В ней также отмечается, что изображения карт и лежащая в основе Magic интеллектуальная собственность принадлежат соответствующим владельцам; доступ к данным и изображениям не предоставляет права собственности или повторного использования сверх применимых условий обслуживания.