/api/meta/changelog
GETDisponibileFRESH

Registro delle modifiche e politica di versionamento

Modifiche dell'API con data, versione attuale, politica di compatibilità e di deprecazione ed elenco degli endpoint legacy con i relativi sostituti.

GET/api/meta/changelog

Richiesta

Questo endpoint non accetta parametri.

Richiesta di esempio

curl -s "https://www.coinboss.com/api/meta/changelog"

Campi della risposta

La tabella dei campi è generata da risposte reali, quindi elenca esattamente ciò che l'endpoint restituisce. I percorsi usano a[] per gli elementi di un array e {*} per gli oggetti indicizzati da un nome dinamico, come una moneta o un exchange.

CampoTipoUnitàDescrizione
successboolean—true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`.
schemastring—ID dello schema di questa risposta (`coinboss.meta.changelog/1`).
nownumbermsOra del server al momento della composizione della risposta.
api_versionstring—Versione dell'API pubblica (`v1`).
catalog_versionstring—Versione del catalogo degli endpoint, una data di rilascio come `2026.11.11`.
policyobject—Regole di versionamento, compatibilità e deprecazione dell'API, come elenchi di enunciati.
policy.versioningarray—Enunciati su come sono versionati l'API e gli schemi delle sue risposte.
policy.versioning[]string—Un enunciato.
policy.compatibilityarray—Enunciati su quali modifiche sono considerate retrocompatibili e su come vengono rappresentati i dati mancanti.
policy.compatibility[]string—Un enunciato.
policy.deprecationarray—Enunciati su come vengono trattati e ritirati gli endpoint `legacy` e `beta`.
policy.deprecation[]string—Un enunciato.
entriesarray—Voci del registro delle modifiche, dalla più recente.
entries[]object—Una voce: `id`, `date`, `version`, `type` (`added`, `changed`, `fixed`, `deprecated`, `removed`), `title` e `items`.
entries[].idstring—Identificatore.
entries[].datestring—Data di calendario (UTC).
entries[].versionstring—Versione del catalogo con cui è stata rilasciata la modifica.
entries[].typestring—Tipo.
entries[].breakingboolean—`true` quando la modifica può compromettere i client esistenti (un campo rimosso o rinominato, un tipo o un significato cambiato). può essere assente
entries[].titlestring—Riepilogo della modifica in una riga.
entries[].itemsarray—Elementi del risultato.
entries[].items[]string—Elementi del risultato.
deprecatedarray—Endpoint contrassegnati come `legacy` o deprecati nel catalogo.
deprecated[]object—Un endpoint: `id`, `path`, `replacement` e `note`.
deprecated[].idstring—Identificatore.
deprecated[].pathstring—Percorso di richiesta dell'endpoint deprecato.
deprecated[].replacementstring—Percorso dell'endpoint da usare al suo posto; null quando non ce n'è alcuno.
deprecated[].notestring—Nota.
metaobject—Envelope di questa risposta: ID dello schema, sistema di origine, timestamp, durata della cache e freschezza.
meta.schemastring—ID dello schema di questa risposta; stesso valore del campo di primo livello `schema`.
meta.sourcearray—Provenienza del valore.
meta.source[]object—Provenienza del valore.
meta.source[].systemstring—Sistema che ha prodotto i dati; sempre `coinboss` per gli endpoint del centro sviluppatori.
meta.source[].componentstring—Componente alla base dei dati: la sonda degli endpoint e il controllo periodico della qualità dei dati.
meta.observed_atnull—Timestamp.
meta.received_atnull—Timestamp.
meta.fetched_atnumbermsMomento in cui CoinBoss ha recuperato i dati dalla fonte.
meta.windowstring—Finestra.
meta.cache_ttl_snumbersDurata della cache lato server di questa risposta.
meta.qualitystring—Sempre `FRESH`: il registro delle modifiche è un contenuto statico distribuito con il rilascio dell'API.
meta.is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
meta.fallbackstring—Nota in testo semplice su ciò che questo endpoint restituisce quando i suoi dati di ingresso sono obsoleti o mancanti.

Generata 2026-11-11 23:01 UTC da 1 risposte reali.

Risposta di esempio

/api/meta/changelog · Risposta reale acquisita 2026-11-13 03:53:45 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: entries conteneva 26 elementi.

  • {
    • "success": true,
    • "schema": "coinboss.meta.changelog/1",
    • "now": 1794542025700,
    • "api_version": "v1",
    • "catalog_version": "2026.11.12",
    • "policy": {
      • "versioning": [ … 3 ],
      • "compatibility": [ … 5 ],
      • "deprecation": [ … 3 ]
      },
    • "entries": [
      • { … 6 },
      • { … 6 }
      ],
    • "deprecated": [
      • { … 4 },
      • { … 4 }
      ],
    • "meta": {
      • "schema": "coinboss.meta.changelog/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": null,
      • "fetched_at": 1794542025700,
      • "window": "latest",
      • "cache_ttl_s": 120,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "static content shipped with the API release"
      }
    }

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
2m
Micro-cache edge
10s
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile
Disponibile dal
2026-11-11

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:53:45 UTCHTTP 2005 msSchema conforme

Disponibilità, ultimi 30 giorni

99.75% di 407 verifiche superate

Errori

Le chiamate non riuscite hanno la stessa struttura su tutti gli endpoint. L'elenco completo è nella pagina degli errori. Errori e limiti di richieste →

CodiceHTTPSignificatoChe cosa fare
INVALID_PARAM400Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto.Non riprovare senza modifiche; correggere la richiesta.
UNAUTHORIZED401L'header `CB-API-KEY` è stato inviato ma la chiave è sconosciuta o revocata. I dati pubblici non richiedono alcuna chiave: rimuovere l'header o usare una chiave valida.Non riprovare senza modifiche.
FORBIDDEN403La route non fa parte dell'API pubblica (interna o riservata agli account).Non riprovare.
NOT_FOUND404Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste.Non riprovare; verificare il percorso e gli identificatori nel catalogo.
RATE_LIMITED429Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere.Attendere `Retry-After`, poi riprovare con backoff.
INTERNAL500Errore imprevisto del server. Il messaggio è volutamente generico; citare `request_id` quando lo si segnala.Riprovare una volta dopo qualche secondo; se persiste, segnalarlo con l'ID della richiesta.
UPSTREAM_FAILED503La fonte di dati alla base di questo endpoint non ha risposto in tempo. Al suo posto non vengono restituiti numeri obsoleti o sostitutivi.Riprovare con backoff; controllare la pagina di stato.
UNAVAILABLE501 / 503Il dataset è temporaneamente non pronto (riscaldamento della cache) oppure l'endpoint non ha ancora una fonte pubblica lecita.Riprovare più tardi; il catalogo contrassegna gli endpoint non disponibili per scelta progettuale.
REQUEST_FAILED200Alcuni endpoint meno recenti rispondono HTTP 200 con `success: false`. Controllare sempre `success`, non solo lo stato HTTP.Dipende dal messaggio; trattare come una richiesta non riuscita.

Prova

GET/api/meta/changelogDisponibile
Parametri

Nessun parametro.

URL della richiestahttps://www.coinboss.com/api/meta/changelog
Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.