/artworks
Просматривайте публичный каталог произведений с проверенными правами.
Публичное
RELICT API · v1.3.29
Арт-аналитика через единый API.
Публичный каталог, доказательная база реестра, рыночные данные с учётом прав, сопоставимые продажи, неизменяемые индексы художников, исследовательская оценка и экспорт с аудитом — через единый версионируемый API.
Публичный каталог без ключаBearer-доступ с областями правПрава на уровне полейВзвешенные единицы
Быстрый старт
Начните с публичного эндпоинта статуса, затем подключите Bearer-ключ с нужными правами.
1
Проверьте спецификацию
Статус и OpenAPI доступны без ключа.
2
Создайте ключ с правами доступа
Создайте API-клиента в рабочем пространстве организации.
3
Обращайтесь к доступным ресурсам
Использование учитывается только после проверки аутентификации и прав доступа.
curl --request GET \
'https://relict.cloud/api/v1/status' \
--header 'Accept: application/json'{
"product": "RELICT API",
"version": "1.3.29",
"status": "operational",
"as_of": "<UTC timestamp>"
}Аутентификация
Коммерческие маршруты реестра и аналитики используют Bearer-ключ с явно заданными правами.
curl --request GET \
'https://relict.cloud/api/v1/registry/search?q=monet' \
--header 'Authorization: Bearer relict_live_…' \
--header 'Accept: application/json'Правила безопасности
Ключи показываются один раз.
Сервер хранит хеши ключей. Восстановить исходный ключ нельзя. Запросы без авторизации или нужных прав отклоняются до списания единиц.
Области доступаКвотыОграничения по IPЖурналы аудита
Основные эндпоинты
Маршруты соответствуют текущей спецификации `/api/v1`. Эндпоинтов-заглушек `/advisor` и `/valuations` нет.
/registry/search
Ищите записи основного реестра в пределах своих прав API.
Bearer + права доступа
/registry/artworks/{uuid}/evidence
Получайте источники, достоверность и подтверждения прав для отдельных полей.
Bearer + права доступа
/intelligence/artworks/{uuid}/sales
Зафиксированные факты продаж в пределах прав клиента.
Bearer + права доступа
/intelligence/artworks/{uuid}/comparables
Ранжируйте сопоставимые продажи; балл сходства не является оценкой стоимости.
Bearer + права доступа
/intelligence/artists/{uuid}/index
Получайте неизменяемые сборки индексов художников и их основания.
Bearer + права доступа
/intelligence/artworks/{uuid}/valuation/research
Запускайте исследовательскую или демонстрационную оценку с основаниями и явным статусом невозможности оценки.
Bearer + права доступа
/exports
Создавайте экспорт с учётом прав и журналом аудита для авторизованных клиентов.
Bearer + права доступа
Генерация клиента OpenAPI
Без выдуманных пакетов npm/Python.
OpenAPI 3.1
Создайте типизированный клиент привычными инструментами своего стека.
https://relict.cloud/api/v1/openapi.jsonСтатус официального SDK
В этом релизе официальный SDK RELICT не опубликован. Используйте спецификацию API как источник для интеграции.
contract: v1.3.29Вебхуки
Настраивается для каждого API-клиента организации.
HTTP-доставка с подписью
настройки в рамках организации
отзыв из рабочего пространства или админки
Статус доставки с аудитом
Единицы RELICT
Вес операций согласно текущим настройкам системы.
search
1 единиц API за принятый запрос.
artist.basic
1 единиц API за принятый запрос.
artwork.basic
1 единиц API за принятый запрос.
artwork.evidence
2 единиц API за принятый запрос.
sales.list
3 единиц API за принятый запрос.
artist.index
4 единиц API за принятый запрос.
market.analytics
5 единиц API за принятый запрос.
comparables
8 единиц API за принятый запрос.
export.create
10 единиц API за принятый запрос.
export.status
1 единиц API за принятый запрос.
export.download
1 единиц API за принятый запрос.
asset.grant
2 единиц API за принятый запрос.
visual.similarity
10 единиц API за принятый запрос.
valuation.ai
20 единиц API за принятый запрос.
API не расширяет права на исходные данные.
Публичные, исследовательские и коммерческие данные с лицензией разграничены политикой использования. Факты продаж отделены от модельных оценок и индексов художников. Источники, даты актуальности, достоверность и методология указываются там, где это предусмотрено API.