RELICT API · v1.3.29

Analisi d’arte attraverso un’unica API.

Catalogo pubblico, evidenze del registro, dati di mercato nel rispetto dei diritti, vendite comparabili, indici immutabili degli artisti, valutazioni di ricerca ed esportazioni tracciate tramite un contratto versionato.

Catalogo pubblico senza chiaveAccesso Bearer per ambitoDiritti a livello di campoUnità ponderate

Avvio rapido

Inizia dall’endpoint di stato pubblico, poi passa all’accesso Bearer con gli ambiti necessari.

1

Verifica il contratto

Leggi stato e OpenAPI senza chiave.

2

Crea una chiave con ambiti

Crea un client API nello spazio dell’organizzazione.

3

Richiama le risorse autorizzate

L’utilizzo viene conteggiato solo dopo la verifica di autenticazione e ambiti.

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

Autenticazione

Le rotte commerciali del registro e delle analisi usano una chiave Bearer con ambiti espliciti.

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

Le chiavi vengono mostrate una sola volta.

Il server conserva hash, non chiavi recuperabili in chiaro. Le richieste non autorizzate o fuori ambito sono rifiutate prima di addebitare unità.

Ambiti di accessoQuoteControlli IPRegistri di controllo

Endpoint principali

Queste rotte provengono dal contratto `/api/v1` attuale, senza endpoint segnaposto `/advisor` o `/valuations`.

OpenAPI completo →
GET

/artworks

Sfoglia il catalogo pubblico di opere con diritti verificati.

Pubblico
GET

/registry/search

Cerca i record del registro con gli ambiti API autorizzati.

Bearer + ambito
GET

/registry/artworks/{uuid}/evidence

Leggi fonti, affidabilità e diritti a livello di campo.

Bearer + ambito
GET

/intelligence/artworks/{uuid}/sales

Vendite osservate disponibili nei limiti dei diritti del client.

Bearer + ambito
GET

/intelligence/artworks/{uuid}/comparables

Classifica vendite comparabili senza trasformare il punteggio in una valutazione.

Bearer + ambito
GET

/intelligence/artists/{uuid}/index

Leggi versioni immutabili degli indici degli artisti e relative evidenze.

Bearer + ambito
POST

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

Esegui valutazioni di ricerca/demo con evidenze e stati espliciti quando la stima non è possibile.

Bearer + ambito
POST

/exports

Crea esportazioni tracciate nel rispetto dei diritti dei client autorizzati.

Bearer + ambito

Generazione client OpenAPI

Nessun pacchetto npm/Python inventato.

Apri specifica →

OpenAPI 3.1

Genera un client tipizzato con gli strumenti già usati nel tuo stack.

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

Stato SDK ufficiale

Questa versione non pubblica un SDK ufficiale RELICT. Il contratto API è il riferimento per l’integrazione.

contract: v1.3.29

Webhook

Configurato per ogni client API dell’organizzazione.

Invio HTTP firmato
Configurazione per organizzazione
Revoca dallo spazio di lavoro o dall’amministrazione
Stato di invio tracciato

Unità RELICT

Utilizzo ponderato degli endpoint secondo la configurazione attuale.

Vedi piani →
Operazione ponderata

search

1 unità API per richiesta accettata.

Operazione ponderata

artist.basic

1 unità API per richiesta accettata.

Operazione ponderata

artwork.basic

1 unità API per richiesta accettata.

Operazione ponderata

artwork.evidence

2 unità API per richiesta accettata.

Operazione ponderata

sales.list

3 unità API per richiesta accettata.

Operazione ponderata

artist.index

4 unità API per richiesta accettata.

Operazione ponderata

market.analytics

5 unità API per richiesta accettata.

Operazione ponderata

comparables

8 unità API per richiesta accettata.

Operazione ponderata

export.create

10 unità API per richiesta accettata.

Operazione ponderata

export.status

1 unità API per richiesta accettata.

Operazione ponderata

export.download

1 unità API per richiesta accettata.

Operazione ponderata

asset.grant

2 unità API per richiesta accettata.

Operazione ponderata

visual.similarity

10 unità API per richiesta accettata.

Operazione ponderata

valuation.ai

20 unità API per richiesta accettata.

Metodologia e diritti

L’API non amplia i diritti sui dati di origine.

Dati pubblici, di ricerca e commerciali su licenza restano separati secondo le regole d’uso. Le vendite osservate sono distinte da stime modellate e indici degli artisti, con fonti, date, affidabilità e metodologia ove previste dal contratto.