RELICT API · v1.3.29

Kunstanalysen über eine einzige API.

Öffentlicher Katalog, Registernachweise, rechtekonforme Marktdaten, Vergleichsverkäufe, unveränderliche Künstlerindizes, Forschungsbewertungen und protokollierte Exporte über einen versionierten Vertrag.

Öffentlicher Katalog ohne SchlüsselBearer-Zugriff mit ScopesRechte auf FeldebeneGewichtete Einheiten

Schnellstart

Beginnen Sie mit dem öffentlichen Status-Endpunkt und wechseln Sie dann zum Bearer-Zugriff mit Scopes.

1

Spezifikation prüfen

Status und OpenAPI sind ohne Schlüssel lesbar.

2

Schlüssel mit Scopes erstellen

Erstellen Sie einen API-Client im Arbeitsbereich Ihrer Organisation.

3

Berechtigte Ressourcen aufrufen

Die Nutzung wird erst nach erfolgreicher Authentifizierung und Scope-Prüfung erfasst.

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>"
}

Authentifizierung

Kommerzielle Register- und Analyse-Endpunkte verwenden einen Bearer-Schlüssel mit expliziten Scopes.

curl --request GET \
  'https://relict.cloud/api/v1/registry/search?q=monet' \
  --header 'Authorization: Bearer relict_live_…' \
  --header 'Accept: application/json'
Sicherheitsregeln

Schlüssel werden nur einmal angezeigt.

Der Server speichert Schlüssel-Hashes; Klartextschlüssel lassen sich nicht abrufen. Nicht autorisierte oder unzulässige Anfragen werden vor dem Verbrauch von Einheiten abgewiesen.

BerechtigungsbereicheKontingenteIP-KontrollenAudit-Protokolle

Zentrale Endpunkte

Diese Routen entsprechen der aktuellen `/api/v1`-Spezifikation. Es gibt keine Platzhalter-Endpunkte `/advisor` oder `/valuations`.

Vollständige OpenAPI →
GET

/artworks

Öffentlichen Kunstkatalog mit geklärten Rechten durchsuchen.

Öffentlich
GET

/registry/search

Verbindliche Registereinträge mit bereichsbezogenem API-Zugriff suchen.

Bearer + Scope
GET

/registry/artworks/{uuid}/evidence

Quellen-, Verlässlichkeits- und Rechtenachweise auf Feldebene lesen.

Bearer + Scope
GET

/intelligence/artworks/{uuid}/sales

Beobachtete Verkaufsdaten im Berechtigungsrahmen des Clients.

Bearer + Scope
GET

/intelligence/artworks/{uuid}/comparables

Vergleichbare Verkäufe ordnen; der Vergleichswert ist keine Bewertung.

Bearer + Scope
GET

/intelligence/artists/{uuid}/index

Unveränderliche Künstlerindex-Versionen und Nachweise lesen.

Bearer + Scope
POST

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

Forschungs-/Demobewertungen mit Nachweisen und explizitem Status bei fehlender Bewertbarkeit ausführen.

Bearer + Scope
POST

/exports

Rechtekonforme, protokollierte Exporte für berechtigte Clients erstellen.

Bearer + Scope

OpenAPI-Client-Generierung

Keine erfundenen npm-/Python-Pakete.

Spezifikation öffnen →

OpenAPI 3.1

Erzeugen Sie einen typisierten Client mit den bewährten Werkzeugen Ihres Stacks.

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

Status des offiziellen SDK

Für diese Version ist kein offizielles RELICT-SDK veröffentlicht. Die API-Spezifikation ist die verbindliche Integrationsgrundlage.

contract: v1.3.29

Webhooks

Für jeden API-Client der Organisation konfiguriert.

Signierte HTTP-Zustellung
Organisationsbezogene Konfiguration
Im Arbeitsbereich oder in der Verwaltung widerrufen
Protokollierter Zustellstatus

RELICT-Einheiten

Gewichteter Endpunktverbrauch gemäß aktueller Systemkonfiguration.

Tarife ansehen →
Gewichtete Operation

search

1 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

artist.basic

1 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

artwork.basic

1 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

artwork.evidence

2 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

sales.list

3 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

artist.index

4 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

market.analytics

5 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

comparables

8 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

export.create

10 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

export.status

1 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

export.download

1 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

asset.grant

2 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

visual.similarity

10 API-Einheiten pro angenommener Anfrage.

Gewichtete Operation

valuation.ai

20 API-Einheiten pro angenommener Anfrage.

Methodik und Rechte

Die API erweitert keine Rechte an den Quelldaten.

Öffentliche, Forschungs- und lizenzierte kommerzielle Daten bleiben nach Nutzungsrichtlinie getrennt. Beobachtete Verkäufe sind von Modellschätzungen und Künstlerindizes getrennt. Quelle, Stichtag, Verlässlichkeit und Methodik werden angegeben, soweit die API sie bereitstellt.