Mulai cepat
Gunakan JSON API untuk cermin lengkap. Gunakan RSS untuk menampilkan publikasi terkini. Keduanya dihasilkan dari kumpulan data publik yang sama. Semua permintaan bersifat hanya baca.
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'Atribusikan rekaman ke KYCLESS, pertahankan penulisnya, dan tautkan kembali ke url. Jaga agar ulasan yang diimpor dapat dibedakan dari ulasan yang diposting langsung di platform Anda.
Titik akhir & filter
GET /api/v1/reviews— arsip dan perubahan, dalam urutan revisi ekspor menaik. Defaultnya mencakup ulasan dan balasan.GET /api/v1/reviews/123— satu catatan. Catatan yang diketahui telah dihapus kembali HTTP 410 dengan batu nisan minimal; ID yang tidak diketahui mengembalikan 404.GET /feeds/reviews.xml— publikasi terbaru yang terlihat berdasarkan tanggal pembuatan asli, yang terbaru terlebih dahulu. Defaultnya mencakup ulasan tingkat atas.GET /api/v1/openapi.json— kontrak OpenAPI 3.1 yang dapat dibaca mesin. HEAD dan OPTIONS didukung.
| Parameter | Arti |
|---|---|
| cursor | JSON daftar saja. Mulai dari 0; lalu gunakan pagination.next_cursor persis seperti yang dikembalikan. Perlakukan itu sebagai string desimal buram. |
| limit | 1–100. JSON bawaan 50; RSS bawaan 20. |
| type | semua, tinjau atau balas. JSON default semua; RSS ulasan bawaan. |
| company_id | ID layanan stabil; direkomendasikan untuk sinkronisasi jangka panjang. ID yang valid tanpa catatan yang cocok akan mengembalikan daftar kosong. |
| service | Siput layanan saat ini, mis. campuran. Gunakan layanan atau id_perusahaan. Siput yang tidak diketahui mengembalikan 404. Siput dapat berubah; ID stabil. |
Parameter yang tidak diketahui, duplikat, atau tidak valid menghasilkan HTTP 400. Pemfilteran menggunakan layanan dan jenis rekaman; penanda penghapusan mempertahankan kunci filter internal tersebut tetapi tidak menampilkan konten lama.
Arsip lengkap, pembaruan & penghapusan
- Mulailah dengan
cursor=0. Masukkan catatan yang diterbitkan olehglobal_id; hapus salinan lokal ketikastatus=deleted. - Ikuti
pagination.next_urlhinggahas_more=false. Jangan menebak atau menambah nilai kursor. - Pertahankan
next_cursorhanya setelah berhasil menerapkan halaman itu. Lakukan polling lagi dengan kursor yang disimpan, biasanya setiap 1–5 menit. - Pisahkan kursor per filter. Mengubah filter memerlukan permulaan dari 0 dan merekonsiliasi kumpulan data lokal yang sesuai.
{
"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.Proyeksi memeriksa data publik paling banyak setiap lima detik sekali. Ini melacak teks yang diedit, skor, tag, penulis, tautan layanan, status resmi, dan suara komentar. Beberapa pengeditan di antara pemeriksaan dapat digabungkan menjadi satu keadaan terakhir: ini adalah sinkronisasi, bukan arsip riwayat edit.
Penghapusan, penghapusan paksa, pembatalan publikasi layanan, atau pengecualian thread yang diimpor menggantikan catatan yang diekspor sebelumnya dengan batu nisan minimal. Teks lama dan muatan penulis/layanan dihapus dari proyeksi. delete_at mencatat ketika ekspor mengamati penghapusan. Menerbitkan ulang rekaman akan menghasilkan revisi yang diterbitkan kemudian.
{
"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"
}Catatan yang berulang adalah hal yang normal: terapkan status hanya jika revisinya lebih baru dari revisi lokal Anda. Umpan dapat melewati revisi yang tidak terkait jika filter disetel. Kursor di depan server mengembalikan 409, misalnya setelah pemulihan: mulai ulang pada 0 dan rekonsiliasi, hapus entri lokal yang tidak ada dalam kumpulan data yang dibangun kembali. Rekonsiliasi penuh secara berkala juga dianjurkan.
Hanya thread KYCLESS asli yang diekspor. Impor di masa depan ditandai secara terpisah dan dikecualikan untuk menghindari impor ulang secara sirkular. Catatan yang dihapus sebelum diekspor tidak memiliki batu nisan ekspor. Batu nisan untuk catatan yang diekspor sebelumnya disimpan tanpa konten pribadi.
Bidang data publik
id / global_id
Senar yang stabil. id bersifat lokal; global_id (kycless:comment:123) diberi namespace secara global. Jangan pernah menghapus duplikat berdasarkan penulis atau teks ulasan.
origin / status / type
origin adalah kycless. status adalah published atau deleted; type adalah review (tingkat atas, termasuk ulasan lama yang belum diberi rating) atau reply.
revision / exported_at
Revisi ekspor monoton (string desimal) dan waktu UTC ketika status ekspor ini berubah. Perubahan metadata dan comment-vote juga menghasilkan revisi baru.
url / parent_id / root_review_id
Tautan permanen asli berakhiran #comment-ID; induk langsung (null untuk root) dan ID thread root. Balasan dapat tetap terlihat setelah akarnya dihapus.
title / display_title / title_is_generated
KYCLESS saat ini tidak memiliki judul ulasan terpisah: title adalah null. display_title adalah judul feed yang dihasilkan, secara eksplisit ditandai dengan title_is_generated=true.
body.source / source_format
Teks publik asli dengan markup sebaris KYCLESS; source_format adalah kycless-inline-v1. Mendukung **bold**, *italic*, __underline__, ~~strike~~ dan [label](https://example.org).
body.text / body.html
Teks biasa dan lolos, HTML yang dirender dengan aman. Gunakan body.text untuk rendering teks dan body.html untuk rendering berformat. Elemen HTML yang diperbolehkan: strong, em, u, s, a dan br. Tautan menggunakan HTTP(S) dan rel=nofollow ugc noopener noreferrer.
rating
Objek {value,min:1,max:5}, atau null jika tidak ada peringkat bintang. Jangan menafsirkan null sebagai nol bintang atau mencampurkan jumlah balasan dengan peringkat ulasan.
tags / votes
Kode tag publik, label dan nada; suara naik/turun pada ulasan/komentar khusus ini. Ini bukan suara keseluruhan dari layanan tersebut.
author
ID publik stabil, nama panggilan, URL profil publik, dan avatar_url. display_name / display_avatar_url mencerminkan nama/logo layanan untuk balasan resmi. Peran akun, kredensial, IP, dan aktivitas pribadi dikecualikan.
is_official
true hanya untuk balasan atas nama layanan dari pemilik layanan saat ini. Ini bukan bendera promosi berbayar.
company
ID stabil, slug/nama saat ini, KYCLESS URL kartu layanan, logo, situs web clearnet utama, dan semua tautan jaringan publik. Tidak ada kredensial administratif atau feed.
created_at / updated_at
Publikasi asli dan waktu edit ulasan sebagai string ISO 8601 UTC. Perubahan metadata dilacak oleh revision / exported_at, belum tentu updated_at.
order_proof_masked / attachments
Hanya referensi pesanan bertopeng yang sama yang ditampilkan secara publik. Referensi pesanan lengkap tidak pernah diekspor. Ulasan saat ini tidak memiliki lampiran; attachments adalah array kosong.
Definisi bidang, nullabilitas, dan skema respons tersedia di API Terbuka. Nilai kosong tetap berupa array null atau kosong. ID dan revisi adalah string; cap waktu menggunakan UTC. Judul ulasan terpisah dan lampiran file saat ini bukan bagian dari produk.
RSS umpan
RSS 2.0 menyediakan 20 ulasan terbaru yang terlihat secara default (hingga 100). Setiap item berisi GUID stabil, tautan permanen asli, judul yang dihasilkan, tanggal publikasi, deskripsi HTML aman, konten yang diformat, dan nama tampilan penulis melalui dc:creator.
content:encoded menyertakan teks berformat lengkap dan tautan ke penulis, layanan, dan ulasan asli. Namespace kycless: menyediakan ID, revisi, jenis, asal, ID induk/root, peringkat, tautan layanan dan penulis, status resmi, waktu pembaruan, dan URL detail JSON. Kode tag publik disertakan sebagai kategori RSS.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100RSS adalah umpan publikasi terkini, bukan saluran arsip atau penghapusan lengkap. GUID tetap stabil di seluruh pengeditan, dan tanggal publikasi tetap mempertahankan arti aslinya. Gunakan kursor API untuk memperbarui catatan lama dan menghapus catatan yang terhapus dengan andal.
Caching, kesalahan & batas penggunaan
API dan batas berbagi feed adalah 120 permintaan/menit per IP, termasuk HEAD dan permintaan bersyarat. Batasan burst di seluruh situs yang ada juga berlaku: kirim permintaan secara berurutan, hindari burst dan polling setiap 1–5 menit. Pada 429 atau 503 patuhi Retry-After. OPTIONS dan dokumen OpenAPI tidak menggunakan kuota khusus ekspor.
Tanggapan mendukung ETag. Kirim If-None-Match dengan respons terakhir ETag untuk menerima HTTP 304 tanpa isi jika tidak diubah. RSS juga mendukung Modifikasi Terakhir / Jika-Dimodifikasi-Sejak; lebih memilih ETag untuk deteksi perubahan yang tepat. CORS memungkinkan pembacaan browser publik tanpa kredensial. Metode penulisan yang tidak didukung menghasilkan 405.
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'Versi 1 menjaga arti bidang yang ada tetap stabil. Bidang opsional tambahan dapat ditambahkan; abaikan bidang yang tidak Anda kenali. Perubahan yang dapat menyebabkan gangguan memerlukan versi API baru. Simpan URL titik akhir dan status kursor dalam konfigurasi integrasi Anda.
Klien Python yang siap dijalankan
Klien perpustakaan standar memelihara cermin SQLite khusus, menangani penomoran halaman kursor, penyisipan ulang, penghapusan, penundaan percobaan ulang, dan pengaturan ulang 409. Itu melakukan data lokal dan kursor secara atom; proses yang gagal diputar kembali. Tidak diperlukan paket Python eksternal atau kunci API.
Unduh kycless_reviews_sync.pypython3 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 --fullJalankan setiap 1–5 menit. Setiap file SQLite termasuk dalam satu cakupan filter; mengubah filter atau menggunakan --full membangun kembali cermin khusus itu. Sesuaikan logika upsert/delete yang sama saat menyimpan data di aplikasi Anda sendiri.
OpenAPI, referensi & kontak
Spesifikasi OpenAPI 3.1 JSON mendokumentasikan semua titik akhir dan varian respons untuk klien dan validasi yang dihasilkan.
Referensi format: RSS 2.0 spesifikasi, HTTP semantik.
Untuk pertanyaan integrasi atau kuota permintaan yang lebih tinggi, gunakan saluran kontak KYCLESS.