Brzi početak
Koristite JSON API za potpuno ogledalo. Koristite RSS za prikaz nedavnih publikacija. Oba su generirana iz istog javnog skupa podataka. Svi zahtjevi su samo za čitanje.
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'Zapise pripišite KYCLESS, sačuvajte autora i povežite natrag na url. Neka se uvezene recenzije razlikuju od recenzija objavljenih izravno na vašoj platformi.
Krajnje točke i filtri
GET /api/v1/reviews— arhiva i promjene, prema rastućem redoslijedu izvoznih revizija. Zadano uključuje i recenzije i odgovore.GET /api/v1/reviews/123— jedan zapis. Poznati uklonjeni zapisi vraćaju se HTTP 410 s minimalnim nadgrobnim spomenikom; nepoznati ID-ovi vraćaju 404.GET /feeds/reviews.xml— najnovije vidljive publikacije prema izvornom datumu stvaranja, prvo najnovije. Zadano uključuje recenzije najviše razine.GET /api/v1/openapi.json— strojno čitljiv OpenAPI 3.1 ugovor. HEAD i OPTIONS su podržani.
| Parametar | Značenje |
|---|---|
| cursor | JSON samo popis. Počnite od 0; zatim koristite pagination.next_cursor točno onako kako je vraćeno. Tretirajte ga kao neprozirni decimalni niz. |
| limit | 1–100 (prikaz, stručni). JSON zadano 50; RSS zadano 20. |
| type | sve, pregledajte ili odgovorite. JSON zadano sve; RSS zadana recenzija. |
| company_id | ID stabilne usluge; preporučuje se za dugotrajnu sinkronizaciju. Važeći ID bez odgovarajućih zapisa vraća prazan popis. |
| service | Trenutačna usluga, npr. mixtum. Upotrijebite service ili company_id. Nepoznati puževi vraćaju 404. Puževi se mogu promijeniti; ID-ovi su stabilni. |
Nepoznati, dupli ili nevažeći parametri vraćaju HTTP 400. Filtriranje koristi uslugu i vrstu zapisa; markeri za brisanje zadržavaju te interne ključeve filtera, ali ne izlažu stari sadržaj.
Kompletna arhiva, ažuriranja i brisanja
- Počnite s
cursor=0. Poništi objavljene zapise od straneglobal_id; uklonite lokalne kopije kadastatus=deleted. - Pratite
pagination.next_urldohas_more=false. Nemojte pogađati niti povećavati vrijednosti kursora. - Ustrajte
next_cursorsamo nakon uspješne primjene te stranice. Ponovno anketirajte sa spremljenim kursorom, obično svakih 1-5 minuta. - Držite odvojene pokazivače po filtru. Promjena filtara zahtijeva početak od 0 i usklađivanje odgovarajućeg lokalnog skupa podataka.
{
"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.Projekcija provjerava predane javne podatke najviše jednom svakih pet sekundi. Prati uređeni tekst, rezultate, oznake, autore, poveznice na usluge, službeni status i glasovanje za komentare. Višestruka uređivanja između provjera mogu se spojiti u jedno najnovije stanje: ovo je sinkronizacija, a ne arhiva povijesti uređivanja.
Brisanje, čvrsto brisanje, poništavanje objave usluge ili isključivanje uvezene niti zamjenjuje prethodno izvezeni zapis minimalnim nadgrobnim spomenikom. Stari tekst i sadržaj autora/usluge uklanjaju se iz projekcije. deleted_at bilježi kada je izvoz primijetio uklanjanje. Ponovno objavljivanje zapisa proizvodi kasniju objavljenu reviziju.
{
"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"
}Ponovljeni zapisi su normalni: primijenite stanje samo kada je njegova revizija novija od vaše lokalne revizije. Sažetak sadržaja može proći kroz nepovezane revizije kada je filtar postavljen. Kursor ispred poslužitelja vraća 409, na primjer nakon vraćanja: ponovno pokrenite na 0 i uskladite, uklanjajući lokalne unose kojih nema u ponovno izgrađenom skupu podataka. Također se preporučuje periodično potpuno usklađivanje.
Izvoze se samo originalne niti KYCLESS. Budući uvozi označeni su zasebno i isključeni kako bi se izbjegao kružni ponovni uvoz. Zapis uklonjen prije nego što je uopće izvezen nema nadgrobni spomenik za izvoz. Nadgrobni spomenici za prethodno izvezene zapise zadržavaju se bez osobnog sadržaja.
Polja javnih podataka
id / global_id
Stabilne žice. id je lokalno; global_id (kycless:comment:123) je globalno imenski prostor. Nikada nemojte uklanjati duplikate po autoru ili tekstu recenzije.
origin / status / type
origin je kycless. status je published ili deleted; type je review (najviša razina, uključujući neocjenjene naslijeđene recenzije) ili reply.
revision / exported_at
Monotona revizija izvoza (decimalni niz) i UTC vrijeme kada se ovo izvezeno stanje promijenilo. Promjene metapodataka i glasovanja komentara također proizvode novu reviziju.
url / parent_id / root_review_id
Izvorna trajna veza završava #comment-ID; izravni roditelj (null za korijen) i ID korijenske niti. Odgovori mogu ostati vidljivi nakon brisanja korijena.
title / display_title / title_is_generated
KYCLESS trenutno nema poseban naslov recenzije: title je null. display_title je generirani naslov feeda, izričito označen sa title_is_generated=true.
body.source / source_format
Izvorni javni tekst s umetnutom oznakom KYCLESS; source_format je kycless-inline-v1. Podržava **bold**, *italic*, __underline__, ~~strike~~ i [label](https://example.org).
body.text / body.html
Običan tekst i izbjegnuti, sigurno prikazani HTML. Koristite body.text za iscrtavanje teksta i body.html za formatirano iscrtavanje. Dopušteni HTML elementi: strong, em, u, s, a i br. Veze koriste HTTP(S) i rel=nofollow ugc noopener noreferrer.
rating
Objekt {value,min:1,max:5}, ili null kada ne postoji ocjena zvjezdicama. Nemojte tumačiti null kao nula zvjezdica niti miješati broj odgovora s ocjenama recenzija.
tags / votes
Javni tag kodovi, oznake i ton; glasova gore/dolje za ovu recenziju/komentar. Ovo nisu ukupni glasovi usluge.
author
Stabilan javni ID, nadimak, URL javnog profila i avatar_url. display_name / display_avatar_url odražavaju naziv/logo usluge za službeni odgovor. Uloga računa, vjerodajnice, IP i privatne aktivnosti su isključeni.
is_official
true samo za odgovor u ime usluge od strane trenutnog vlasnika usluge. To nije plaćena promotivna oznaka.
company
Stabilni ID, trenutni slug/ime, URL servisne kartice KYCLESS, logotip, primarno Clearnet web mjesto i sve javne mrežne veze. Nema administrativnih vjerodajnica ili vjerodajnica za feed.
created_at / updated_at
Izvorna publikacija i vrijeme uređivanja pregleda kao ISO 8601 UTC nizovi. Promjene metapodataka prate revision / exported_at, ne nužno updated_at.
order_proof_masked / attachments
Javno prikazana samo ista maskirana referenca narudžbe. Pune reference narudžbe nikada se ne izvoze. Recenzije trenutno nemaju privitaka; attachments je prazan niz.
Definicije polja, nullabilnost i sheme odgovora dostupne su u OpenAPI. Prazne vrijednosti ostaju null ili prazni nizovi. ID-ovi i revizije su nizovi; vremenske oznake koriste UTC. Odvojeni naslovi recenzija i privici datoteka trenutno nisu dio proizvoda.
RSS feed
RSS 2.0 prema zadanim postavkama nudi zadnjih 20 vidljivih recenzija (do 100). Svaka stavka sadrži stabilan GUID, originalnu trajnu vezu, generirano zaglavlje, datum objave, siguran HTML opis, formatirani sadržaj i prikazno ime autora putem dc:creator.
content:encoded uključuje puni formatirani tekst i poveznice na autora, uslugu i izvornu recenziju. kycless: imenski prostor daje ID-ove, reviziju, vrstu, porijeklo, nadređene/korijenske ID-ove, ocjenu, usluge i veze autora, službeni status, vrijeme ažuriranja i URL pojedinosti JSON. Kodovi javnih oznaka uključeni su kao RSS kategorije.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100RSS je feed nedavnih publikacija, a ne kompletna arhiva ili kanal za brisanje. GUID-ovi ostaju stabilni tijekom uređivanja, a datumi objavljivanja zadržavaju svoje izvorno značenje. Koristite kursor API za pouzdano ažuriranje starih zapisa i uklanjanje izbrisanih.
Predmemorija, pogreške i ograničenja upotrebe
API i feed dijele ograničenje od 120 zahtjeva po minuti po IP-u, uključujući HEAD i uvjetne zahtjeve. Primjenjuju se i postojeća ograničenja burst-ova na cijelom web-mjestu: zahtjeve šaljite sekvencijalno, izbjegavajte burstove i anketirajte svakih 1-5 minuta. Na 429 ili 503 poslušajte Retry-After. OPTIONS i OpenAPI dokument ne troše kvotu specifičnu za izvoz.
Odgovori podržavaju ETag. Pošaljite If-None-Match sa zadnjim odgovorom ETag da biste primili HTTP 304 bez tijela kada je nepromijenjen. RSS također podržava Last-Modified / If-Modified-Since; preferirajte ETag za precizno otkrivanje promjena. CORS dopušta javno čitanje preglednika bez vjerodajnica. Nepodržane metode pisanja vraćaju 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'Verzija 1 održava postojeća značenja polja stabilnima. Mogu se dodati dodatna izborna polja; ignorirajte polja koja ne prepoznajete. Prijelomne promjene zahtijevaju novu verziju API. Zadržite URL krajnje točke i stanje kursora u konfiguraciji integracije.
Python klijent spreman za rad
Klijent standardne biblioteke održava namjensko SQLite zrcalo, upravlja paginacijom kursora, umetanjima, brisanjem, odgodama ponovnog pokušaja i resetiranjem 409. On predaje lokalne podatke i kursor atomski; neuspjela izvođenja roll back. Nisu potrebni vanjski Python paketi ili ključ API.
Preuzmi 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 --fullPokrenite ga svakih 1-5 minuta. Svaka SQLite datoteka pripada jednom opsegu filtera; promjena filtra ili korištenje --full ponovno gradi to namjensko ogledalo. Prilagodite istu logiku postavljanja/brisanja prilikom pohranjivanja podataka u vlastitu aplikaciju.
OpenAPI, reference i kontakt
OpenAPI 3.1 JSON specifikacija dokumentira sve krajnje točke i varijante odgovora za generirane klijente i provjeru valjanosti.
Reference formata: RSS 2.0 specifikacija, HTTP semantika.
Za pitanja integracije ili veću kvotu zahtjeva koristite kontakt kanali KYCLESS.