Pornire rapidă
Utilizați JSON API pentru o oglindă completă. Utilizați RSS pentru a afișa publicațiile recente. Ambele sunt generate din același set de date publice. Toate solicitările sunt numai în citire.
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'Atribuiți înregistrările la KYCLESS, păstrați autorul și conectați înapoi la url. Păstrați recenziile importate distincte de recenziile postate direct pe platforma dvs.
Puncte finale și filtre
GET /api/v1/reviews— arhivare și modificări, în ordine crescătoare de revizuire a exportului. Valoarea implicită include atât recenzii, cât și răspunsuri.GET /api/v1/reviews/123— o înregistrare. Înregistrările cunoscute eliminate returnează HTTP 410 cu o piatră funerară minimă; ID-urile necunoscute returnează 404.GET /feeds/reviews.xml— cele mai recente publicații vizibile după data creării inițiale, primele cele mai noi. Valoarea implicită include recenzii de nivel superior.GET /api/v1/openapi.json— contract OpenAPI 3.1 care poate fi citit de mașină. HEAD și OPTIONS sunt acceptate.
| Parametru | Sens |
|---|---|
| cursor | Numai lista JSON. Începe de la 0; apoi utilizați pagination.next_cursor exact așa cum este returnat. Tratați-l ca pe un șir zecimal opac. |
| limit | 1–100. JSON implicit 50; RSS implicit 20. |
| type | toate, revizuiți sau răspundeți. JSON implicit toate; RSS revizuire implicită. |
| company_id | ID de serviciu stabil; recomandat pentru sincronizare de lungă durată. Un ID valid fără înregistrări care se potrivesc returnează o listă goală. |
| service | Slug de serviciu curent, de ex. mixtum. Utilizați fie service, fie company_id. Limacșii necunoscuți revin 404. Limacșii se pot schimba; ID-urile sunt stabile. |
Parametrii necunoscuți, duplicați sau invalidi returnează HTTP 400. Filtrarea utilizează serviciul și tipul înregistrării; markerii de ștergere păstrează acele chei de filtru interne, dar nu expun conținut vechi.
Arhiva completă, actualizări și ștergeri
- Începe cu
cursor=0. Upsert înregistrările publicate deglobal_id; eliminați copiile locale cândstatus=deleted. - Urmați
pagination.next_urlpână lahas_more=false. Nu ghiciți și nu incrementați valorile cursorului. - Persistați
next_cursornumai după ce ați aplicat cu succes acea pagină. Interogați din nou cu cursorul salvat, de obicei la fiecare 1-5 minute. - Păstrați cursoare separate pentru fiecare filtru. Schimbarea filtrelor necesită pornirea de la 0 și reconcilierea setului de date local corespunzător.
{
"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.Proiecțiile verifică datele publice comise cel mult o dată la cinci secunde. Acesta urmărește textul editat, scorurile, etichetele, autorii, linkurile de servicii, statutul oficial și voturile pentru comentarii. Editările multiple între verificări se pot reuni într-o singură stare: aceasta este sincronizare, nu o arhivă cu istoricul editărilor.
Ștergerea, ștergerea tare, nepublicarea serviciului sau excluderea unui fir importat înlocuiește o înregistrare anterior exportată cu o piatră funerară minimă. Textul vechi și încărcăturile utile de autor/serviciu sunt eliminate din proiecție. deleted_at înregistrează când exportul a observat eliminarea. Republicarea înregistrării produce o revizuire publicată ulterioară.
{
"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"
}Înregistrările repetate sunt normale: aplicați o stare numai atunci când revizuirea sa este mai nouă decât cea locală. Fluxul poate avansa peste revizuiri care nu au legătură atunci când este setat un filtru. Un cursor înaintea serverului returnează 409, de exemplu după o restaurare: reporniți la 0 și reconciliați, eliminând intrările locale absente din setul de date reconstruit. De asemenea, se recomandă reconcilierea completă periodică.
Sunt exportate numai firele originale KYCLESS. Importurile viitoare sunt marcate separat și excluse pentru a evita reimporturile circulare. O înregistrare eliminată înainte de a fi exportată nu are nicio piatră funerară de export. Pietrele funerare pentru înregistrările exportate anterior sunt păstrate fără conținut personal.
Câmpuri de date publice
id / global_id
Corzi stabile. id este local; global_id (kycless:comment:123) este spațial de nume la nivel global. Nu deduplicați niciodată după autor sau textul de recenzie.
origin / status / type
origin este kycless. status este published sau deleted; type este review (nivel superior, inclusiv recenzii vechi neevaluate) sau reply.
revision / exported_at
Revizuirea monotonă a exportului (șir zecimal) și ora UTC când s-a schimbat starea exportată. Modificările metadatelor și comentariilor-vot produc, de asemenea, o nouă revizuire.
url / parent_id / root_review_id
Permalink original care se termină #comment-ID; părinte direct (null pentru o rădăcină) și ID-ul firului rădăcină. Răspunsurile pot rămâne vizibile după ce rădăcina lor este ștearsă.
title / display_title / title_is_generated
KYCLESS nu are în prezent un titlu separat de recenzie: title este null. display_title este un antet de feed generat, marcat în mod explicit cu title_is_generated=true.
body.source / source_format
Text public original cu marcaj inline KYCLESS; source_format este kycless-inline-v1. Suportă **bold**, *italic*, __underline__, ~~strike~~ și [label](https://example.org).
body.text / body.html
Text simplu și HTML redat în siguranță. Utilizați body.text pentru redarea textului și body.html pentru redarea formatată. Elemente HTML permise: strong, em, u, s, a și br. Linkurile folosesc HTTP(S) și rel=nofollow ugc noopener noreferrer.
rating
Obiect {value,min:1,max:5} sau null când nu există nicio evaluare cu stele. Nu interpretați null ca zero stele și nu amestecați numărul de răspunsuri cu evaluările recenziilor.
tags / votes
Codurile de etichete publice, etichetele și tonul; voturi sus/jos pentru această recenzie/comentar specific. Acestea nu sunt voturile generale ale serviciului.
author
ID public stabil, porecla, adresa URL a profilului public și avatar_url. display_name / display_avatar_url reflectă numele/sigla serviciului pentru un răspuns oficial. Rolul contului, acreditările, IP-urile și activitatea privată sunt excluse.
is_official
true numai pentru un răspuns în numele serviciului din partea unui proprietar actual al serviciului. Nu este un steag de promovare plătită.
company
ID stabil, slug/nume actual, KYCLESS adresa URL a cardului de serviciu, sigla, site-ul web principal Clearnet și toate linkurile de rețea publică. Fără acreditări administrative sau de feed.
created_at / updated_at
Publicarea originală și orele de editare a revizuirii ca șiruri ISO 8601 UTC. Modificările metadatelor sunt urmărite prin revision / exported_at, nu neapărat updated_at.
order_proof_masked / attachments
Doar aceeași referință de comandă mascata este afișată public. Referințele complete ale comenzii nu sunt niciodată exportate. Recenziile nu au în prezent atașamente; attachments este o matrice goală.
Definițiile câmpurilor, anulabilitatea și schemele de răspuns sunt disponibile în OpenAPI. Valorile goale rămân nule sau matrice goale. ID-urile și revizuirile sunt șiruri de caractere; marcajele temporale folosesc UTC. Titlurile de recenzii separate și fișierele atașate nu fac parte în prezent din produs.
RSS feed
RSS 2.0 oferă în mod implicit cele mai recente 20 de recenzii vizibile (până la 100). Fiecare articol conține un GUID stabil, permalink original, antet generat, data publicării, descriere HTML sigură, conținut formatat și numele afișat al autorului prin dc:creator.
content:encoded include textul complet formatat și link-uri către autor, serviciu și recenzie originală. Spațiul de nume kycless: furnizează ID-uri, revizuire, tip, origine, ID-uri părinte/rădăcină, evaluare, legături de servicii și autor, starea oficială, timpul de actualizare și adresa URL a detaliilor JSON. Codurile etichetelor publice sunt incluse ca categorii 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 este un flux de publicații recente, nu arhiva completă sau canalul de ștergere. GUID-urile rămân stabile între editări, iar datele de publicare își păstrează sensul inițial. Utilizați cursorul API pentru a actualiza în mod fiabil înregistrările vechi și pentru a le elimina pe cele șterse.
Memorarea în cache, erori și limite de utilizare
API și feed-uri partajează o limită de 120 de solicitări/minut per IP, inclusiv solicitările HEAD și condiționate. Se aplică și limitele de explozie existente la nivelul întregului site: trimiteți cererile secvenţial, evitați exploziile și sondajele la fiecare 1-5 minute. Pe 429 sau 503 respectați Retry-After. OPȚIUNI și documentul OpenAPI nu consumă cota specifică exportului.
Răspunsurile suportă ETag. Trimiteți If-None-Match cu ultimul răspuns ETag pentru a primi un HTTP 304 fără corp atunci când este neschimbat. RSS acceptă, de asemenea, Last-Modified / If-Modified-Since; preferați ETag pentru detectarea precisă a modificărilor. CORS permite citirea publică a browserului fără acreditări. Metodele de scriere neacceptate returnează 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'Versiunea 1 menține stabile semnificațiile câmpurilor existente. Pot fi adăugate câmpuri opționale suplimentare; ignorați câmpurile pe care nu le recunoașteți. Modificările finale necesită o nouă versiune API. Păstrați adresa URL a punctului final și starea cursorului în configurația de integrare.
Client Python gata de rulare
Clientul de bibliotecă standard menține o oglindă SQLite dedicată, se ocupă de paginarea cursorului, upsertările, ștergerile, întârzierile din reîncercare și o resetare 409. Commite atomic datele locale și cursorul; alergările eșuate se derulează înapoi. Nu sunt necesare pachete externe Python sau cheie API.
Descarcă 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 --fullRulați-l la fiecare 1-5 minute. Fiecare fișier SQLite aparține unui singur domeniu de filtrare; schimbarea filtrului sau utilizarea --full reconstruiește acea oglindă dedicată. Adaptați aceeași logică de susținere/ștergere atunci când stocați date în propria aplicație.
OpenAPI, referințe și contact
Specificația OpenAPI 3.1 JSON documentează toate punctele finale și variantele de răspuns pentru clienții generați și validare.
Referințe de format: RSS specificație 2.0, HTTP semantică.
Pentru întrebări de integrare sau o cotă de solicitare mai mare, utilizați canalele de contact KYCLESS.