Mabilis na pagsisimula
Gamitin ang JSON API para sa kumpletong salamin. Gamitin ang RSS upang ipakita ang mga kamakailang publikasyon. Parehong nabuo mula sa parehong pampublikong dataset. Ang lahat ng mga kahilingan ay read-only.
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'I-attribute ang mga tala sa KYCLESS, panatilihin ang may-akda at i-link pabalik sa url. Panatilihing nakikilala ang mga na-import na review sa mga review na direktang naka-post sa iyong platform.
Mga endpoint at filter
GET /api/v1/reviews— archive at mga pagbabago, sa pataas na pagkakasunud-sunod ng pagbabago sa pag-export. Kasama sa default ang parehong mga review at tugon.GET /api/v1/reviews/123— isang record. Ang mga kilalang inalis na tala ay nagbabalik HTTP 410 na may kaunting lapida; Ang mga hindi kilalang ID ay nagbabalik ng 404.GET /feeds/reviews.xml— pinakabagong nakikitang mga publikasyon ayon sa orihinal na petsa ng paggawa, pinakabago muna. Kasama sa default ang mga top-level na review.GET /api/v1/openapi.json— kontrata ng OpenAPI 3.1 na nababasa ng makina. HEAD at OPTIONS ay suportado.
| Parameter | Ibig sabihin |
|---|---|
| cursor | JSON listahan lamang. Magsimula sa 0; pagkatapos ay gamitin ang pagination.next_cursor nang eksakto tulad ng ibinalik. Tratuhin ito bilang isang opaque decimal string. |
| limit | 1–100. JSON default 50; RSS default 20. |
| type | lahat, suriin o sagutin. JSON default lahat; RSS default na pagsusuri. |
| company_id | Matatag na ID ng serbisyo; inirerekomenda para sa mahabang buhay na pag-synchronize. Ang isang wastong ID na walang katugmang mga tala ay nagbabalik ng isang walang laman na listahan. |
| service | Kasalukuyang service slug, hal. mixtum. Gamitin ang alinman sa serbisyo o company_id. Ang mga hindi kilalang slug ay nagbabalik ng 404. Maaaring magbago ang mga slug; Ang mga ID ay matatag. |
Ang hindi alam, duplicate o invalid na mga parameter ay nagbabalik HTTP 400. Ang pag-filter ay gumagamit ng serbisyo at uri ng record; Pinapanatili ng mga pananda ng pagtanggal ang mga panloob na key ng filter na iyon ngunit hindi naglalantad ng lumang nilalaman.
Kumpletuhin ang archive, mga update at pagtanggal
- Magsimula sa
cursor=0. I-upsert ang mga nai-publish na tala niglobal_id; alisin ang mga lokal na kopya kapagstatus=deleted. - Sundin ang
pagination.next_urlhangganghas_more=false. Huwag hulaan o dagdagan ang mga halaga ng cursor. - Magpatuloy lamang
next_cursorpagkatapos matagumpay na ilapat ang pahinang iyon. Poll muli gamit ang naka-save na cursor, karaniwang bawat 1-5 minuto. - Panatilihin ang hiwalay na mga cursor sa bawat filter. Ang pagpapalit ng mga filter ay nangangailangan ng simula sa 0 at i-reconcile ang kaukulang lokal na dataset.
{
"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.Ang mga pagsusuri ng projection ay nakagawa ng pampublikong data nang hindi hihigit sa isang beses bawat limang segundo. Sinusubaybayan nito ang na-edit na teksto, mga marka, mga tag, mga may-akda, mga link ng serbisyo, opisyal na katayuan at mga boto ng komento. Maraming mga pag-edit sa pagitan ng mga pagsusuri ay maaaring magsama sa isang pinakabagong estado: ito ay pag-synchronize, hindi isang archive ng kasaysayan ng pag-edit.
Ang pagtanggal, mahirap na pagtanggal, hindi paglalathala ng serbisyo o pagbubukod ng isang imported na thread ay pinapalitan ang dating na-export na tala ng kaunting lapida. Ang mga lumang text at payload ng may-akda/serbisyo ay inalis sa projection. deleted_at records kapag naobserbahan ng pag-export ang pagtanggal. Ang muling pag-publish ng rekord ay nagdudulot ng mas huling nai-publish na rebisyon.
{
"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"
}Ang mga paulit-ulit na tala ay normal: ilapat lamang ang isang estado kapag ang rebisyon nito ay mas bago kaysa sa iyong lokal na rebisyon. Maaaring isulong ng feed ang mga hindi nauugnay na rebisyon kapag nakatakda ang isang filter. Ang isang cursor sa unahan ng server ay nagbabalik ng 409, halimbawa pagkatapos ng isang pag-restore: i-restart sa 0 at i-reconcile, inaalis ang mga lokal na entry na wala sa itinayong muli na dataset. Inirerekomenda din ang pana-panahong buong pagkakasundo.
Ang orihinal na KYCLESS na mga thread lamang ang na-export. Ang mga pag-import sa hinaharap ay minarkahan nang hiwalay at hindi kasama upang maiwasan ang mga pabilog na muling pag-import. Ang isang rekord na inalis bago ito na-export ay walang export na lapida. Ang mga lapida para sa dati nang na-export na mga tala ay pinananatili nang walang personal na nilalaman.
Mga field ng pampublikong data
id / global_id
Matatag na mga string. id ay lokal; Ang global_id (kycless:comment:123) ay globally namespaced. Huwag kailanman i-deduplicate ng may-akda o teksto ng pagsusuri.
origin / status / type
Ang origin ay kycless. Ang status ay published o deleted; Ang type ay review (nangungunang antas, kasama ang hindi na-rate na mga legacy na review) o reply.
revision / exported_at
Monotonic export revision (decimal string) at UTC time kung kailan nagbago ang na-export na estado na ito. Ang mga pagbabago sa metadata at komento-boto ay gumagawa din ng bagong rebisyon.
url / parent_id / root_review_id
Orihinal na permalink na nagtatapos sa #comment-ID; direktang magulang (null para sa isang ugat) at root thread ID. Maaaring manatiling nakikita ang mga tugon pagkatapos matanggal ang kanilang ugat.
title / display_title / title_is_generated
Ang KYCLESS ay kasalukuyang walang hiwalay na pamagat ng pagsusuri: title ay null. Ang display_title ay isang nabuong feed heading, na tahasang minarkahan ng title_is_generated=true.
body.source / source_format
Orihinal na pampublikong teksto na may KYCLESS inline na markup; Ang source_format ay kycless-inline-v1. Sinusuportahan ang **bold**, *italic*, __underline__, ~~strike~~ at [label](https://example.org).
body.text / body.html
Plain text at nakatakas, ligtas na nai-render na HTML. Gamitin ang body.text para sa pag-render ng text at body.html para sa naka-format na pag-render. Mga pinapayagang elemento ng HTML: strong, em, u, s, a at br. Gumagamit ang mga link ng HTTP(S) at rel=nofollow ugc noopener noreferrer.
rating
Bagay na {value,min:1,max:5}, o null kapag walang star rating na umiiral. Huwag i-interpret ang null bilang zero star o paghaluin ang mga bilang ng tugon sa mga rating ng review.
tags / votes
Mga code ng pampublikong tag, label at tono; pataas/pababa na mga boto sa partikular na pagsusuri/komento na ito. Hindi ito ang mga pangkalahatang boto ng serbisyo.
author
Matatag na pampublikong ID, palayaw, URL ng pampublikong profile at avatar_url. display_name / display_avatar_url ipakita ang pangalan/logo ng serbisyo para sa isang opisyal na tugon. Ang tungkulin ng account, mga kredensyal, mga IP at pribadong aktibidad ay hindi kasama.
is_official
true para lamang sa isang tugon sa ngalan ng serbisyo ng kasalukuyang may-ari ng serbisyo. Ito ay hindi isang bayad na bandila ng promosyon.
company
Stable ID, kasalukuyang slug/pangalan, KYCLESS service card URL, logo, pangunahing clearnet website at lahat ng pampublikong link sa network. Walang mga kredensyal sa administratibo o feed.
created_at / updated_at
Orihinal na publikasyon at mga oras ng pag-edit ng pagsusuri bilang mga string ng ISO 8601 UTC. Ang mga pagbabago sa metadata ay sinusubaybayan ng revision / exported_at, hindi updated_at.
order_proof_masked / attachments
Ang parehong naka-mask na sanggunian ng order na ipinapakita sa publiko. Ang mga full order reference ay hindi kailanman na-export. Ang mga review ay kasalukuyang walang mga kalakip; Ang attachments ay isang walang laman na array.
Available ang mga kahulugan ng field, nullability at response schema sa OpenAPI. Ang mga walang laman na halaga ay mananatiling null o walang laman na mga array. Ang mga ID at rebisyon ay mga string; Ang mga timestamp ay gumagamit ng UTC. Kasalukuyang hindi bahagi ng produkto ang magkahiwalay na mga heading ng review at mga attachment ng file.
RSS feed
Ang RSS 2.0 ay nagbibigay ng pinakabagong 20 nakikitang review bilang default (hanggang 100). Ang bawat item ay naglalaman ng stable na GUID, orihinal na permalink, nabuong heading, petsa ng publikasyon, ligtas na paglalarawan ng HTML, naka-format na nilalaman at display name ng may-akda sa pamamagitan ng dc:creator.
Kasama sa content:encoded ang buong na-format na teksto at mga link sa may-akda, serbisyo at orihinal na pagsusuri. Ang kycless: namespace ay nagbibigay ng mga ID, rebisyon, uri, pinagmulan, parent/root ID, rating, serbisyo at mga link ng may-akda, opisyal na katayuan, oras ng pag-update at ang JSON URL ng detalye. Ang mga pampublikong tag code ay kasama bilang RSS kategorya.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100Ang RSS ay isang feed ng kamakailang mga publikasyon, hindi ang kumpletong archive o channel ng pagtanggal. Ang mga GUID ay nananatiling matatag sa lahat ng mga pag-edit, at ang mga petsa ng publikasyon ay nagpapanatili ng kanilang orihinal na kahulugan. Gamitin ang API cursor upang mapagkakatiwalaang i-update ang mga lumang record at alisin ang mga tinanggal.
Pag-cache, mga error at limitasyon sa paggamit
API at ang feed ay nagbabahagi ng limitasyon na 120 kahilingan/minuto bawat IP, kasama ang HEAD at mga kondisyonal na kahilingan. Nalalapat din ang mga kasalukuyang limitasyon sa pagsabog sa buong site: magpadala ng mga kahilingan nang sunud-sunod, iwasan ang mga pagsabog at poll bawat 1–5 minuto. Sa 429 o 503 sundin ang Retry-After. Ang OPTIONS at ang OpenAPI na dokumento ay hindi gumagamit ng quota na partikular sa pag-export.
Sinusuportahan ng mga tugon ang ETag. Ipadala ang If-None-Match na may huling tugon na ETag para makatanggap ng body-free HTTP 304 kapag hindi nabago. Sinusuportahan din ng RSS ang Last-Modified / If-Modified-Since; mas gusto ang ETag para sa tumpak na pagtuklas ng pagbabago. Binibigyang-daan ng CORS ang pagbabasa ng pampublikong browser nang walang mga kredensyal. Ang mga hindi sinusuportahang paraan ng pagsulat ay nagbabalik ng 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'Pinapanatili ng Bersyon 1 na stable ang mga kasalukuyang kahulugan ng field. Maaaring magdagdag ng mga karagdagang opsyonal na field; huwag pansinin ang mga patlang na hindi mo nakikilala. Ang mga paglabag sa pagbabago ay nangangailangan ng bagong API na bersyon. Panatilihin ang endpoint URL at status ng cursor sa iyong configuration ng integration.
Ready-to-run na Python client
Ang karaniwang-library client ay nagpapanatili ng isang dedikadong SQLite mirror, pinangangasiwaan ang cursor pagination, upserts, pagtanggal, muling pagsubok na pagkaantala at isang 409 reset. Gumagawa ito ng lokal na data at ang cursor sa atomically; nabigong tumakbo pabalik. Walang mga panlabas na pakete ng Python o API key ang kailangan.
I-download ang 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 --fullPatakbuhin ito tuwing 1-5 minuto. Ang bawat SQLite file ay kabilang sa isang saklaw ng filter; pagpapalit ng filter o paggamit ng --full muling itinatayo ang nakalaang salamin na iyon. Iangkop ang parehong upsert/delete logic kapag nag-iimbak ng data sa iyong sariling application.
OpenAPI, mga sanggunian at contact
OpenAPI 3.1 JSON detalye nagdodokumento ng lahat ng endpoint at mga variant ng tugon para sa mga nabuong kliyente at pagpapatunay.
Mga sanggunian sa format: RSS 2.0 na detalye, HTTP semantika.
Para sa mga tanong sa pagsasama o mas mataas na quota ng kahilingan, gamitin ang ang KYCLESS contact channel.