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.
/api/meta/changelogRichiesta
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.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| schema | string | — | ID dello schema di questa risposta (`coinboss.meta.changelog/1`). |
| now | number | ms | Ora del server al momento della composizione della risposta. |
| api_version | string | — | Versione dell'API pubblica (`v1`). |
| catalog_version | string | — | Versione del catalogo degli endpoint, una data di rilascio come `2026.11.11`. |
| policy | object | — | Regole di versionamento, compatibilità e deprecazione dell'API, come elenchi di enunciati. |
| policy.versioning | array | — | Enunciati su come sono versionati l'API e gli schemi delle sue risposte. |
| policy.versioning[] | string | — | Un enunciato. |
| policy.compatibility | array | — | Enunciati su quali modifiche sono considerate retrocompatibili e su come vengono rappresentati i dati mancanti. |
| policy.compatibility[] | string | — | Un enunciato. |
| policy.deprecation | array | — | Enunciati su come vengono trattati e ritirati gli endpoint `legacy` e `beta`. |
| policy.deprecation[] | string | — | Un enunciato. |
| entries | array | — | 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[].id | string | — | Identificatore. |
| entries[].date | string | — | Data di calendario (UTC). |
| entries[].version | string | — | Versione del catalogo con cui è stata rilasciata la modifica. |
| entries[].type | string | — | Tipo. |
| entries[].breaking | boolean | — | `true` quando la modifica può compromettere i client esistenti (un campo rimosso o rinominato, un tipo o un significato cambiato). può essere assente |
| entries[].title | string | — | Riepilogo della modifica in una riga. |
| entries[].items | array | — | Elementi del risultato. |
| entries[].items[] | string | — | Elementi del risultato. |
| deprecated | array | — | Endpoint contrassegnati come `legacy` o deprecati nel catalogo. |
| deprecated[] | object | — | Un endpoint: `id`, `path`, `replacement` e `note`. |
| deprecated[].id | string | — | Identificatore. |
| deprecated[].path | string | — | Percorso di richiesta dell'endpoint deprecato. |
| deprecated[].replacement | string | — | Percorso dell'endpoint da usare al suo posto; null quando non ce n'è alcuno. |
| deprecated[].note | string | — | Nota. |
| meta | object | — | Envelope di questa risposta: ID dello schema, sistema di origine, timestamp, durata della cache e freschezza. |
| meta.schema | string | — | ID dello schema di questa risposta; stesso valore del campo di primo livello `schema`. |
| meta.source | array | — | Provenienza del valore. |
| meta.source[] | object | — | Provenienza del valore. |
| meta.source[].system | string | — | Sistema che ha prodotto i dati; sempre `coinboss` per gli endpoint del centro sviluppatori. |
| meta.source[].component | string | — | Componente alla base dei dati: la sonda degli endpoint e il controllo periodico della qualità dei dati. |
| meta.observed_at | null | — | Timestamp. |
| meta.received_at | null | — | Timestamp. |
| meta.fetched_at | number | ms | Momento in cui CoinBoss ha recuperato i dati dalla fonte. |
| meta.window | string | — | Finestra. |
| meta.cache_ttl_s | number | s | Durata della cache lato server di questa risposta. |
| meta.quality | string | — | Sempre `FRESH`: il registro delle modifiche è un contenuto statico distribuito con il rilascio dell'API. |
| meta.is_stale | boolean | — | true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali. |
| meta.fallback | string | — | 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"
- "compatibility"
- "deprecation"
- "entries"
- "deprecated"
- "meta"
- "schema""coinboss.meta.changelog/1"
- "source"
- "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
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 →
| Codice | HTTP | Significato | Che cosa fare |
|---|---|---|---|
| INVALID_PARAM | 400 | Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto. | Non riprovare senza modifiche; correggere la richiesta. |
| UNAUTHORIZED | 401 | L'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. |
| FORBIDDEN | 403 | La route non fa parte dell'API pubblica (interna o riservata agli account). | Non riprovare. |
| NOT_FOUND | 404 | Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste. | Non riprovare; verificare il percorso e gli identificatori nel catalogo. |
| RATE_LIMITED | 429 | Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere. | Attendere `Retry-After`, poi riprovare con backoff. |
| INTERNAL | 500 | Errore 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_FAILED | 503 | La 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. |
| UNAVAILABLE | 501 / 503 | Il 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_FAILED | 200 | Alcuni 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
/api/meta/changelogDisponibileNessun parametro.
https://www.coinboss.com/api/meta/changelogAltro in questa categoria
- Matrice della qualità dei dati (vista del collector) /api/sd/quality
- Catalogo dell'API /api/meta/catalog
- Registro delle modifiche e politica di versionamento /api/meta/changelog
- Documentazione di un endpoint /api/meta/endpoint
- Documento OpenAPI /api/meta/openapi
- Matrice della qualità dei dati /api/meta/quality
- Stato del servizio /api/meta/status
- Verifica se il simbolo di una moneta è noto alla piattaforma /api/coin-exists
- Mappa dal simbolo della moneta al percorso dell'icona ospitata in locale /api/coin-icons
- Riepilogo aggregato della pagina moneta /api/content/coin
- Riepilogo delle sezioni dell'intero sito /api/content/summary
- Tabella dei tassi di cambio fiat /api/currency/fx
- Mappa dall'ID dell'exchange al percorso dell'icona ospitata in locale /api/exchange-icons
- Controllo di liveness /api/health
- Statistiche della pagina di ricerca /api/research/stats