RELICT API · v1.3.29

L’analyse du marché de l’art via une seule API.

Catalogue public, preuves du registre, données de marché selon les droits, ventes comparables, indices d’artistes immuables, estimations de recherche et exports audités via un contrat versionné.

Catalogue public sans cléAccès Bearer par périmètreDroits par champUnités pondérées

Démarrage rapide

Commencez par le statut public, puis utilisez un accès Bearer avec les périmètres nécessaires.

1

Vérifier le contrat

Consultez le statut et OpenAPI sans clé.

2

Créer une clé avec périmètres

Créez un client API dans l’espace de votre organisation.

3

Appeler les ressources autorisées

L’utilisation n’est comptée qu’après validation de l’authentification et des périmètres.

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

Authentification

Les routes commerciales du registre et de l’analyse utilisent une clé Bearer avec des périmètres explicites.

curl --request GET \
  'https://relict.cloud/api/v1/registry/search?q=monet' \
  --header 'Authorization: Bearer relict_live_…' \
  --header 'Accept: application/json'
Règles de sécurité

Les clés ne sont affichées qu’une fois.

Le serveur conserve des empreintes, sans clés récupérables en clair. Les requêtes non autorisées ou hors périmètre sont rejetées avant le décompte des unités.

Périmètres d’accèsQuotasContrôles IPJournaux d’audit

Endpoints principaux

Ces routes proviennent du contrat `/api/v1` actuel, sans endpoints fictifs `/advisor` ou `/valuations`.

OpenAPI complet →
GET

/artworks

Parcourez le catalogue public d’œuvres aux droits vérifiés.

Public
GET

/registry/search

Recherchez les enregistrements du registre avec les périmètres API autorisés.

Bearer + périmètre
GET

/registry/artworks/{uuid}/evidence

Consultez les sources, la fiabilité et les droits au niveau des champs.

Bearer + périmètre
GET

/intelligence/artworks/{uuid}/sales

Faits de vente observés accessibles selon les droits du client.

Bearer + périmètre
GET

/intelligence/artworks/{uuid}/comparables

Classez les ventes comparables sans assimiler le score à une estimation.

Bearer + périmètre
GET

/intelligence/artists/{uuid}/index

Consultez les versions immuables des indices d’artistes et leurs preuves.

Bearer + périmètre
POST

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

Lancez une estimation de recherche/démo avec preuves et état explicite lorsqu’elle est impossible.

Bearer + périmètre
POST

/exports

Créez des exports audités selon les droits des clients autorisés.

Bearer + périmètre

Génération de client OpenAPI

Aucun nom de paquet npm/Python fictif.

Ouvrir la spécification →

OpenAPI 3.1

Générez un client typé avec les outils déjà utilisés dans votre environnement.

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

État du SDK officiel

Aucun SDK officiel RELICT n’est publié dans cette version. Le contrat API constitue la référence d’intégration.

contract: v1.3.29

Webhooks

Configuré pour chaque client API de l’organisation.

Livraison HTTP signée
Configuration par organisation
Révocation depuis l’espace de travail ou l’administration
État de livraison audité

Unités RELICT

Utilisation pondérée des endpoints selon la configuration actuelle.

Voir les offres →
Opération pondérée

search

1 unités API par requête acceptée.

Opération pondérée

artist.basic

1 unités API par requête acceptée.

Opération pondérée

artwork.basic

1 unités API par requête acceptée.

Opération pondérée

artwork.evidence

2 unités API par requête acceptée.

Opération pondérée

sales.list

3 unités API par requête acceptée.

Opération pondérée

artist.index

4 unités API par requête acceptée.

Opération pondérée

market.analytics

5 unités API par requête acceptée.

Opération pondérée

comparables

8 unités API par requête acceptée.

Opération pondérée

export.create

10 unités API par requête acceptée.

Opération pondérée

export.status

1 unités API par requête acceptée.

Opération pondérée

export.download

1 unités API par requête acceptée.

Opération pondérée

asset.grant

2 unités API par requête acceptée.

Opération pondérée

visual.similarity

10 unités API par requête acceptée.

Opération pondérée

valuation.ai

20 unités API par requête acceptée.

Méthodologie et droits

L’API n’étend pas les droits sur ses données sources.

Les données publiques, de recherche et commerciales sous licence restent séparées selon leur politique d’utilisation. Les ventes observées sont distinctes des estimations modélisées et indices d’artistes, avec sources, dates, fiabilité et méthodologie lorsque le contrat les expose.