Değişiklik günlüğü ve sürümleme politikası
Tarihli API değişiklikleri, güncel sürüm, uyumluluk ve kullanım dışı bırakma politikası ile eski uç noktaların ve yerlerine geçenlerin listesi.
/api/meta/changelogİstek
Bu uç nokta parametre almaz.
Örnek istek
curl -s "https://www.coinboss.com/api/meta/changelog"Yanıt alanları
Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| schema | string | — | Bu yanıtın şema kimliği (`coinboss.meta.changelog/1`). |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| api_version | string | — | Herkese açık API'nin sürümü (`v1`). |
| catalog_version | string | — | Uç nokta kataloğunun sürümü; `2026.11.11` gibi bir yayın tarihi. |
| policy | object | — | API'nin sürümleme, uyumluluk ve kullanımdan kaldırma kuralları; ifade listeleri olarak. |
| policy.versioning | array | — | API'nin ve yanıt şemalarının nasıl sürümlendiğine ilişkin ifadeler. |
| policy.versioning[] | string | — | Tek bir ifade. |
| policy.compatibility | array | — | Hangi değişikliklerin uyumluluğu bozmayan değişiklik sayıldığına ve eksik verinin nasıl temsil edildiğine ilişkin ifadeler. |
| policy.compatibility[] | string | — | Tek bir ifade. |
| policy.deprecation | array | — | `legacy` ve `beta` uç noktalarının nasıl ele alındığına ve nasıl kullanımdan kaldırıldığına ilişkin ifadeler. |
| policy.deprecation[] | string | — | Tek bir ifade. |
| entries | array | — | Değişiklik günlüğü kayıtları, en yenisi başta. |
| entries[] | object | — | Tek bir kayıt: `id`, `date`, `version`, `type` (`added`, `changed`, `fixed`, `deprecated`, `removed`), `title` ve `items`. |
| entries[].id | string | — | Tanımlayıcı. |
| entries[].date | string | — | Takvim tarihi (UTC). |
| entries[].version | string | — | Değişikliğin yayımlandığı katalog sürümü. |
| entries[].type | string | — | Tür. |
| entries[].breaking | boolean | — | Değişiklik mevcut istemcileri bozabiliyorsa `true` (bir alanın kaldırılması veya yeniden adlandırılması, bir türün veya anlamın değişmesi). bulunmayabilir |
| entries[].title | string | — | Değişikliğin tek satırlık özeti. |
| entries[].items | array | — | Sonuç öğeleri. |
| entries[].items[] | string | — | Sonuç öğeleri. |
| deprecated | array | — | Katalogda `legacy` veya kullanımdan kaldırılmış olarak işaretlenen uç noktalar. |
| deprecated[] | object | — | Tek bir uç nokta: `id`, `path`, `replacement` ve `note`. |
| deprecated[].id | string | — | Tanımlayıcı. |
| deprecated[].path | string | — | Kullanımdan kaldırılan uç noktanın istek yolu. |
| deprecated[].replacement | string | — | Yerine kullanılacak uç noktanın yolu; yoksa null. |
| deprecated[].note | string | — | Not. |
| meta | object | — | Bu yanıtın zarfı: şema kimliği, üreten sistem, zaman damgaları, önbellek ömrü ve güncellik. |
| meta.schema | string | — | Bu yanıtın şema kimliği; üst düzeydeki `schema` ile aynı değer. |
| meta.source | array | — | Değerin nereden geldiği. |
| meta.source[] | object | — | Değerin nereden geldiği. |
| meta.source[].system | string | — | Veriyi üreten sistem; geliştirici merkezi uç noktaları için her zaman `coinboss`. |
| meta.source[].component | string | — | Verinin arkasındaki bileşen: uç nokta yoklaması ve veri kalitesi devriyesi. |
| meta.observed_at | null | — | Zaman damgası. |
| meta.received_at | null | — | Zaman damgası. |
| meta.fetched_at | number | ms | CoinBoss'un veriyi kaynaktan getirdiği zaman. |
| meta.window | string | — | Pencere. |
| meta.cache_ttl_s | number | s | Bu yanıtın sunucu tarafı önbellek ömrü. |
| meta.quality | string | — | Her zaman `FRESH`: değişiklik günlüğü, API sürümüyle birlikte yayımlanan statik içeriktir. |
| meta.is_stale | boolean | — | Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz. |
| meta.fallback | string | — | Girdileri eskimiş veya eksik olduğunda bu uç noktanın ne döndürdüğüne ilişkin düz metin not. |
Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/meta/changelog · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:45 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: entries: 26 öğe içeriyordu.
- "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"
Ayrıntılar
- Kimlik doğrulama
- Yok. Herkese açık uç nokta.
- İstek sınırı
- IP başına dakikada 1200 istek
- Sunucu önbelleği
- 2m
- Edge mikro önbelleği
- 10s
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
- Kullanıma sunulma
- 2026-11-11
Canlı durum
Erişilebilirlik, son 30 gün
407 kontrolde başarı oranı: %99.75
Hatalar
Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir. | Değiştirmeden yeniden denemeyin; isteği düzeltin. |
| UNAUTHORIZED | 401 | `CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın. | Değiştirmeden yeniden denemeyin. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir. | `Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin. |
| INTERNAL | 500 | Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin. | Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin. |
| UPSTREAM_FAILED | 503 | Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez. | Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin. |
| UNAVAILABLE | 501 / 503 | Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok. | Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler. |
| REQUEST_FAILED | 200 | Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin. | Mesaja bağlıdır; başarısız bir istek olarak ele alın. |
Deneyin
/api/meta/changelogKullanılabilirParametre yok.
https://www.coinboss.com/api/meta/changelogBu kategoride daha fazlası
- Veri kalitesi matrisi (toplayıcı görünümü) /api/sd/quality
- API kataloğu /api/meta/catalog
- Değişiklik günlüğü ve sürümleme politikası /api/meta/changelog
- Uç nokta dokümantasyonu /api/meta/endpoint
- OpenAPI belgesi /api/meta/openapi
- Veri kalitesi matrisi /api/meta/quality
- Servis durumu /api/meta/status
- Bir coin sembolünün platformda tanımlı olup olmadığını kontrol eder /api/coin-exists
- Coin sembolünden yerel olarak barındırılan simge yoluna eşleme /api/coin-icons
- Coin sayfası toplu özeti /api/content/coin
- Site geneli bölüm özeti /api/content/summary
- İtibari para döviz kuru tablosu /api/currency/fx
- Borsa kimliğinden yerel olarak barındırılan simge yoluna eşleme /api/exchange-icons
- Canlılık kontrolü /api/health
- Araştırma sayfası istatistikleri /api/research/stats