İçeriğe atla
Geliştiriciler

KYCLESS İncelemeler API & RSS

Orijinal genel incelemeler, yanıtlar ve hizmet meta verileri. Kazınmaya gerek kalmadan eksiksiz bir arşiv ve güvenilir güncellemeler. Hesap veya API anahtarı gerekmez.

Hızlı başlangıç

Tam bir ayna için JSON API tuşlarını kullanın. En son yayınları görüntülemek için RSS tuşunu kullanın. Her ikisi de aynı genel veri kümesinden oluşturulmuştur. Tüm istekler salt okunurdur.

curl 'https://kycless.cc/api/v1/reviews?limit=100'
curl 'https://kycless.cc/api/v1/reviews?service=mixtum&type=review'
curl 'https://kycless.cc/feeds/reviews.xml?service=mixtum'

Kayıtları KYCLESS ile ilişkilendirin, yazarı koruyun ve url'ye geri bağlantı verin. İçe aktarılan incelemeleri doğrudan platformunuzda yayınlanan incelemelerden ayırt edilebilir tutun.

Uç noktalar ve filtreler

  • GET /api/v1/reviews — artan dışa aktarma revizyon sırasına göre arşivleme ve değişiklikler. Varsayılan, hem incelemeleri hem de yanıtları içerir.
  • GET /api/v1/reviews/123 — bir kayıt. Bilinen kaldırılmış kayıtlar minimum mezar taşıyla HTTP 410 değerini döndürür; bilinmeyen kimlikler 404 değerini döndürür.
  • GET /feeds/reviews.xml — orijinal oluşturulma tarihine göre en yeni görünür yayınlar, en yenisi önce gelir. Varsayılan, üst düzey incelemeleri içerir.
  • GET /api/v1/openapi.json — makine tarafından okunabilen OpenAPI 3.1 sözleşmesi. HEAD ve OPTIONS desteklenir.
ParametreAnlam
cursorJSON yalnızca liste. 0'dan başlayın; daha sonra pagination.next_cursor'u tam olarak döndürüldüğü gibi kullanın. Bunu opak bir ondalık dize olarak ele alın.
limit1–100. JSON varsayılan 50; RSS varsayılan 20.
typehepsi, inceleyin veya yanıtlayın. JSON varsayılan tümü; RSS varsayılan inceleme.
company_idKararlı hizmet kimliği; uzun ömürlü senkronizasyon için önerilir. Eşleşen kaydı olmayan geçerli bir kimlik, boş bir liste döndürür.
serviceMevcut hizmet kesintisi, ör. karışım. Hizmet veya şirket_id'sini kullanın. Bilinmeyen sümüklü böcekler 404 değerini döndürür. Sümüklü böcekler değişebilir; Kimlikler sabit.

Bilinmeyen, yinelenen veya geçersiz parametreler HTTP 400 değerini döndürür. Filtreleme, kaydın hizmetini ve türünü kullanır; silme işaretleri bu dahili filtre anahtarlarını korur ancak eski içeriği göstermez.

Tam arşiv, güncellemeler ve silmeler

  1. cursor=0 ile başlayın. Yayınlanan kayıtları global_id'ye kadar yükseltin; status=deleted olduğunda yerel kopyaları kaldırın.
  2. pagination.next_url'yi has_more=false'ye kadar takip edin. İmleç değerlerini tahmin etmeyin veya artırmayın.
  3. Yalnızca bu sayfayı başarıyla uyguladıktan sonra next_cursor'de ısrar edin. Kaydedilen imleçle normalde her 1-5 dakikada bir yeniden yoklama yapın.
  4. Filtre başına ayrı imleçler tutun. Filtreleri değiştirmek, 0'dan başlamayı ve karşılık gelen yerel veri kümesini uzlaştırmayı gerektirir.
{
  "version": "1",
  "data": [],
  "pagination": {
    "has_more": false,
    "next_cursor": "250",
    "next_url": "https://kycless.cc/api/v1/reviews?cursor=250&limit=50&type=all"
  },
  "sync": {"watermark": "250", "refresh_interval_seconds": 5, "mode": "current_state"}
}
// Illustration of pagination fields, not a complete response.
// The full response also includes the source object.

Projeksiyon, taahhüt edilen kamuya açık verileri en fazla beş saniyede bir kontrol eder. Düzenlenen metni, puanları, etiketleri, yazarları, hizmet bağlantılarını, resmi durumu ve yorum oylarını izler. Kontroller arasındaki birden fazla düzenleme, tek bir son durum halinde birleşebilir: bu bir düzenleme geçmişi arşivi değil, senkronizasyondur.

İçe aktarılan bir iş parçacığının silinmesi, kalıcı olarak silinmesi, hizmetin yayından kaldırılması veya hariç tutulması, daha önce dışa aktarılan bir kaydın minimum düzeyde bir işaret taşı ile değiştirilmesini sağlar. Eski metin ve yazar/hizmet yükleri projeksiyondan kaldırılır. Dışa aktarma işleminde silinme gözlemlendiğinde silinen_at kayıtları. Kaydın yeniden yayınlanması daha sonra yayınlanmış bir revizyona neden olur.

{
  "id": "123", "global_id": "kycless:comment:123",
  "origin": "kycless", "status": "deleted", "type": "review",
  "deleted_at": "2026-11-04T12:00:00.000Z",
  "revision": "251", "exported_at": "2026-11-04T12:00:00.000Z"
}

Tekrarlanan kayıtlar normaldir: Bir durumu yalnızca revizyonu yerel revizyonunuzdan daha yeni olduğunda uygulayın. Bir filtre ayarlandığında feed, ilgisiz revizyonların ötesine geçebilir. Sunucunun önündeki bir imleç, örneğin bir geri yüklemeden sonra 409 değerini döndürür: 0'dan yeniden başlatın ve uzlaştırın, yeniden oluşturulan veri kümesinde bulunmayan yerel girişleri kaldırın. Periyodik tam mutabakat da tavsiye edilir.

Yalnızca orijinal KYCLESS konuları dışa aktarılır. Gelecekteki ithalatlar ayrı olarak işaretlenir ve döngüsel yeniden ithalatları önlemek için hariç tutulur. İhraç edilmeden önce kaldırılan bir kaydın ihracat mezar taşı yoktur. Daha önce dışa aktarılan kayıtlara ait mezar taşları kişisel içerik olmadan tutulur.

Genel veri alanları

id / global_id

Kararlı dizeler. id yereldir; global_id (kycless:comment:123) genel olarak ad alanıdır. Asla yazara veya inceleme metnine göre tekilleştirmeyin.

origin / status / type

origin, kycless'dir. status, published veya deleted'dir; type, review (derecelendirilmemiş eski incelemeler dahil üst düzey) veya reply'dir.

revision / exported_at

Monoton dışa aktarma revizyonu (ondalık dize) ve bu dışa aktarılan durumun değiştiği UTC saati. Meta veriler ve yorum-oy değişiklikleri de yeni bir revizyon üretir.

url / parent_id / root_review_id

Orijinal kalıcı bağlantı sonu #comment-ID; doğrudan ebeveyn (kök için null) ve kök iş parçacığı kimliği. Yanıtlar, kökleri silindikten sonra görünür durumda kalabilir.

title / display_title / title_is_generated

KYCLESS'nin şu anda ayrı bir inceleme başlığı yok: title, null'dir. display_title, açıkça title_is_generated=true ile işaretlenmiş, oluşturulmuş bir yayın başlığıdır.

body.source / source_format

KYCLESS satır içi işaretlemeye sahip orijinal genel metin; source_format, kycless-inline-v1'dir. **bold**, *italic*, __underline__, ~~strike~~ ve [label](https://example.org)'yi destekler.

body.text / body.html

Düz metin ve kaçışlı, güvenli bir şekilde oluşturulmuş HTML. Metin işleme için body.text ve biçimlendirilmiş işleme için body.html kullanın. İzin verilen HTML öğeleri: strong, em, u, s, a ve br. Bağlantılarda HTTP(S) ve rel=nofollow ugc noopener noreferrer kullanılır.

rating

Yıldız derecelendirmesi olmadığında {value,min:1,max:5} veya null nesnesini kullanın. null'yi sıfır yıldız olarak yorumlamayın veya yanıt sayılarını yorum puanlarıyla karıştırmayın.

tags / votes

Genel etiket kodları, etiketler ve ton; Bu spesifik incelemeye/yoruma yönelik yukarı/aşağı oylar. Bunlar hizmetin genel oyları değildir.

author

Sabit genel kimlik, takma ad, genel profil URL'si ve avatar_url. display_name / display_avatar_url resmi bir yanıt için hizmet adını/logosunu yansıtır. Hesap rolü, kimlik bilgileri, IP'ler ve özel etkinlik hariçtir.

is_official

true yalnızca mevcut bir hizmet sahibinin hizmet adına verdiği yanıt için. Ücretli bir tanıtım bayrağı değildir.

company

Sabit kimlik, geçerli bilgi/ad, KYCLESS servis kartı URL'si, logo, birincil clearnet web sitesi ve tüm genel ağ bağlantıları. Yönetici veya feed kimlik bilgisi yok.

created_at / updated_at

Orijinal yayın ve inceleme düzenleme süreleri ISO 8601 UTC dizeleri olarak. Meta veri değişiklikleri updated_at olarak değil, revision / exported_at ile izlenir.

order_proof_masked / attachments

Yalnızca aynı maskeli sipariş referansı herkese açık olarak gösterilir. Tam sipariş referansları hiçbir zaman dışa aktarılmaz. İncelemelerin şu anda hiçbir eki yoktur; attachments boş bir dizidir.

Alan tanımları, geçersiz kılınabilirlik ve yanıt şemaları OpenAPI'de mevcuttur. Boş değerler boş veya boş dizilerde kalır. Kimlikler ve revizyonlar dizelerdir; zaman damgaları UTC'yi kullanır. Ayrı inceleme başlıkları ve dosya ekleri şu anda ürünün bir parçası değildir.

RSS besleme

RSS 2.0, varsayılan olarak en son 20 görünür incelemeyi sağlar (100'e kadar). Her öğe, dc:creator aracılığıyla sabit bir GUID, orijinal kalıcı bağlantı, oluşturulan başlık, yayın tarihi, güvenli HTML açıklaması, biçimlendirilmiş içerik ve yazarın görünen adını içerir.

content:encoded tam biçimlendirilmiş metni ve yazara, hizmete ve orijinal incelemeye bağlantılar içerir. kycless: ad alanı kimlikleri, revizyonu, türü, kökeni, üst/kök kimliklerini, derecelendirmeyi, hizmet ve yazar bağlantılarını, resmi durumu, güncelleme zamanını ve JSON ayrıntı URL'sini sağlar. Genel etiket kodları RSS kategori olarak yer almaktadır.

https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100

RSS tam arşiv veya silme kanalı değil, yeni yayınlar beslemesidir. GUID'ler tüm düzenlemelerde sabit kalır ve yayın tarihleri ​​orijinal anlamlarını korur. Eski kayıtları güvenilir bir şekilde güncellemek ve silinenleri kaldırmak için API imlecini kullanın.

Önbelleğe alma, hatalar ve kullanım sınırları

API ve yayın paylaşımı, HEAD ve koşullu istekler dahil olmak üzere IP başına 120 istek/dakika sınırına sahiptir. Site genelindeki mevcut ani artış sınırları da geçerlidir: İstekleri sırayla gönderin, ani artışlardan kaçının ve her 1-5 dakikada bir anket yapın. 429 veya 503'te Retry-After'e uyun. SEÇENEKLER ve OpenAPI belgesi, dışa aktarmaya özel kotayı tüketmez.

Yanıtlar ETag'ı destekliyor. Değişmediğinde gövdesiz bir HTTP 304 almak için son yanıt ETag ile If-None-Match gönderin. RSS aynı zamanda Son Değiştirilme / Değiştirildiyse-Since'yi de destekler; Hassas değişiklik tespiti için ETag'ı tercih edin. CORS, kimlik bilgileri olmadan genel tarayıcı okumalarına izin verir. Desteklenmeyen yazma yöntemleri 405 değerini döndürür.

curl -i 'https://kycless.cc/api/v1/reviews?cursor=0'
# Repeat with the ETag value returned above:
curl -i -H 'If-None-Match: "PASTE_ETAG_HERE"' \
  'https://kycless.cc/api/v1/reviews?cursor=0'

Sürüm 1, mevcut alan anlamlarını sabit tutar. İlave isteğe bağlı alanlar eklenebilir; tanımadığınız alanları dikkate almayın. Son değişiklikler yeni bir API sürümü gerektirir. Uç nokta URL'sini ve imleç durumunu entegrasyon yapılandırmanızda tutun.

Çalıştırılmaya hazır Python istemcisi

Standart kütüphane istemcisi, özel bir SQLite aynasını korur, imleç sayfalandırmayı, yükseltmeleri, silmeleri, yeniden deneme gecikmelerini ve 409 sıfırlamayı yönetir. Yerel verileri ve imleci atomik olarak işler; başarısız çalıştırmalar geri alınır. Harici Python paketine veya API anahtarına gerek yoktur.

kycless_reviews_sync.py dosyasını indir
python3 kycless_reviews_sync.py --database kycless-reviews.sqlite
# Optional: synchronize only one service
python3 kycless_reviews_sync.py --database service.sqlite --company-id 123
# Periodic full reconciliation
python3 kycless_reviews_sync.py --database kycless-reviews.sqlite --full

Her 1-5 dakikada bir çalıştırın. Her SQLite dosyası bir filtre kapsamına aittir; filtreyi değiştirmek veya --full kullanmak bu özel aynayı yeniden oluşturur. Verileri kendi uygulamanızda saklarken aynı yükseltme/silme mantığını uyarlayın.

OpenAPI, referanslar ve iletişim

OpenAPI 3.1 JSON spesifikasyonu oluşturulan istemciler ve doğrulama için tüm uç noktaları ve yanıt değişkenlerini belgeler.

Referansları biçimlendir: RSS 2.0 spesifikasyonu, HTTP anlambilim.

Entegrasyon soruları veya daha yüksek istek kotası için KYCLESS iletişim kanalları kullanın.