RELICT API · v1.3.29

ひとつの 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` エンドポイントはありません。

OpenAPI 全体 →
GET

/artworks

権利確認済みの公開作品カタログを閲覧。

公開
GET

/registry/search

API のスコープに従って正規登録簿を検索。

Bearer + スコープ
GET

/registry/artworks/{uuid}/evidence

フィールドごとの出典、信頼度、権利の根拠を取得。

Bearer + スコープ
GET

/intelligence/artworks/{uuid}/sales

呼び出し元の利用権限で取得できる売買の観測情報。

Bearer + スコープ
GET

/intelligence/artworks/{uuid}/comparables

比較可能な売買を順位付けします。スコアは評価額ではありません。

Bearer + スコープ
GET

/intelligence/artists/{uuid}/index

不変のアーティスト指数ビルドと根拠を取得。

Bearer + スコープ
POST

/intelligence/artworks/{uuid}/valuation/research

根拠と評価不能状態を明示した研究・デモ用評価を実行。

Bearer + スコープ
POST

/exports

権限を持つクライアント向けに、権利に配慮した監査記録付きエクスポートを作成。

Bearer + スコープ

OpenAPI クライアントの生成

架空の npm/Python パッケージ名は掲載しません。

仕様を開く →

OpenAPI 3.1

普段お使いのツールで型付きクライアントを生成できます。

https://relict.cloud/api/v1/openapi.json

公式 SDK の状況

このリリースでは公式 RELICT SDK パッケージは公開されていません。API 仕様を統合の基準としてお使いください。

contract: v1.3.29

Webhook

組織の 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 によって元データの利用権利が拡張されることはありません。

公開・研究・商用ライセンスのデータは利用方針に従って区分されます。観測された売買はモデル推定やアーティスト指数と区別され、仕様で提供する範囲で出典、基準日、信頼度、方法論を伴います。