Журнал изменений и политика версионирования
Датированные изменения API, текущая версия, политика совместимости и вывода из эксплуатации, а также список унаследованных эндпоинтов с их заменами.
/api/meta/changelogЗапрос
У этого эндпоинта нет параметров.
Пример запроса
curl -s "https://www.coinboss.com/api/meta/changelog"Поля ответа
Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.
| Поле | Тип | Единица | Описание |
|---|---|---|---|
| success | boolean | — | true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`. |
| schema | string | — | Идентификатор схемы этого ответа (`coinboss.meta.changelog/1`). |
| now | number | ms | Время сервера в момент формирования ответа. |
| api_version | string | — | Версия публичного API (`v1`). |
| catalog_version | string | — | Версия каталога эндпоинтов — дата релиза, например `2026.11.11`. |
| policy | object | — | Правила версионирования, совместимости и вывода из эксплуатации API в виде списков утверждений. |
| policy.versioning | array | — | Утверждения о том, как версионируются API и схемы его ответов. |
| policy.versioning[] | string | — | Одно утверждение. |
| policy.compatibility | array | — | Утверждения о том, какие изменения считаются не нарушающими совместимость и как представляются отсутствующие данные. |
| policy.compatibility[] | string | — | Одно утверждение. |
| policy.deprecation | array | — | Утверждения о том, как обрабатываются и выводятся из эксплуатации эндпоинты `legacy` и `beta`. |
| policy.deprecation[] | string | — | Одно утверждение. |
| entries | array | — | Записи журнала изменений, сначала новые. |
| entries[] | object | — | Одна запись: `id`, `date`, `version`, `type` (`added`, `changed`, `fixed`, `deprecated`, `removed`), `title` и `items`. |
| entries[].id | string | — | Идентификатор. |
| entries[].date | string | — | Календарная дата (UTC). |
| entries[].version | string | — | Версия каталога, в которой вышло изменение. |
| entries[].type | string | — | Тип. |
| entries[].breaking | boolean | — | `true`, если изменение может нарушить работу существующих клиентов (поле удалено или переименовано, изменён тип или смысл). может отсутствовать |
| entries[].title | string | — | Краткое описание изменения в одну строку. |
| entries[].items | array | — | Элементы результата. |
| entries[].items[] | string | — | Элементы результата. |
| deprecated | array | — | Эндпоинты, помеченные в каталоге как `legacy` или устаревшие. |
| deprecated[] | object | — | Один эндпоинт: `id`, `path`, `replacement` и `note`. |
| deprecated[].id | string | — | Идентификатор. |
| deprecated[].path | string | — | Путь запроса устаревшего эндпоинта. |
| deprecated[].replacement | string | — | Путь эндпоинта, который следует использовать вместо него; null, если замены нет. |
| deprecated[].note | string | — | Примечание. |
| meta | object | — | Обёртка этого ответа: идентификатор схемы, система-источник, метки времени, время жизни кеша и актуальность. |
| meta.schema | string | — | Идентификатор схемы этого ответа; то же значение, что и `schema` верхнего уровня. |
| meta.source | array | — | Откуда взято значение. |
| meta.source[] | object | — | Откуда взято значение. |
| meta.source[].system | string | — | Система, сформировавшая данные; для эндпоинтов центра разработчика всегда `coinboss`. |
| meta.source[].component | string | — | Компонент, стоящий за данными: проверка эндпоинтов и патруль качества данных. |
| meta.observed_at | null | — | Метка времени. |
| meta.received_at | null | — | Метка времени. |
| meta.fetched_at | number | ms | Время, когда CoinBoss получил данные от источника. |
| meta.window | string | — | Окно. |
| meta.cache_ttl_s | number | s | Время жизни серверного кеша этого ответа. |
| meta.quality | string | — | Всегда `FRESH`: журнал изменений — статическое содержимое, поставляемое вместе с релизом API. |
| meta.is_stale | boolean | — | true, если строка старше окна актуальности; устаревшие строки в итогах не используются. |
| meta.fallback | string | — | Текстовое пояснение того, что возвращает этот эндпоинт, когда его входные данные устарели или отсутствуют. |
Сформировано 2026-11-11 23:01 UTC; использовано реальных ответов: 1.
Пример ответа
/api/meta/changelog · Реальный ответ, получен 2026-11-13 04:03:43 UTC. Длинные массивы и словари сокращены для отображения: entries: элементов было 26.
- "success"true
- "schema""coinboss.meta.changelog/1"
- "now"1794542623679
- "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"1794542623679
- "window""latest"
- "cache_ttl_s"120
- "quality""FRESH"
- "is_stale"false
- "fallback""static content shipped with the API release"
Сведения
- Аутентификация
- Не требуется. Публичный эндпоинт.
- Лимит запросов
- 1200 запросов в минуту на один IP
- Серверный кеш
- 2m
- Пограничный микрокеш
- 10s
- Метки времени
- Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
- Формат ответа
- json
- Стабильность
- Стабильный
- Доступен с
- 2026-11-11
Текущий статус
Доступность за последние 30 дней
Пройдено 99.76% из 409 проверок
Ошибки
Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →
| Код | HTTP | Значение | Что делать |
|---|---|---|---|
| INVALID_PARAM | 400 | Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен. | Не повторяйте запрос без изменений; исправьте его. |
| UNAUTHORIZED | 401 | Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ. | Не повторяйте запрос без изменений. |
| FORBIDDEN | 403 | Маршрут не входит в публичный API (внутренний или только для аккаунта). | Не повторяйте запрос. |
| NOT_FOUND | 404 | Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует. | Не повторяйте запрос; сверьте путь и идентификаторы с каталогом. |
| RATE_LIMITED | 429 | Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать. | Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой. |
| INTERNAL | 500 | Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`. | Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса. |
| UPSTREAM_FAILED | 503 | Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются. | Повторите запрос с нарастающей задержкой; проверьте страницу статуса. |
| UNAVAILABLE | 501 / 503 | Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника. | Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению. |
| REQUEST_FAILED | 200 | Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP. | Зависит от сообщения; считайте запрос неудачным. |
Попробовать
/api/meta/changelogДоступенПараметров нет.
https://www.coinboss.com/api/meta/changelogДругие эндпоинты этой категории
- Матрица качества данных (представление коллекторов) /api/sd/quality
- Каталог API /api/meta/catalog
- Журнал изменений и политика версионирования /api/meta/changelog
- Документация эндпоинта /api/meta/endpoint
- Документ OpenAPI /api/meta/openapi
- Матрица качества данных /api/meta/quality
- Статус сервиса /api/meta/status
- Проверка, известен ли платформе символ монеты /api/coin-exists
- Соответствие символа монеты пути к локально размещённой иконке /api/coin-icons
- Агрегированная сводка для страницы монеты /api/content/coin
- Сводка по разделам сайта /api/content/summary
- Таблица курсов фиатных валют /api/currency/fx
- Соответствие идентификатора биржи пути к локально размещённой иконке /api/exchange-icons
- Проверка работоспособности /api/health
- Статистика для страниц исследований /api/research/stats