Szybki start
Użyj JSON API, aby uzyskać pełne lustro. Użyj RSS, aby wyświetlić najnowsze publikacje. Obydwa są generowane na podstawie tego samego publicznego zbioru danych. Wszystkie żądania są tylko do odczytu.
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'Przypisz rekordy do KYCLESS, zachowaj autora i podaj link z powrotem do url. Zadbaj o to, aby zaimportowane recenzje odróżniały się od recenzji publikowanych bezpośrednio na Twojej platformie.
Punkty końcowe i filtry
GET /api/v1/reviews— archiwum i zmiany, w rosnącej kolejności rewizji eksportu. Domyślnie uwzględniane są zarówno recenzje, jak i odpowiedzi.GET /api/v1/reviews/123— jeden rekord. Znane usunięte zapisy zwracają HTTP 410 z minimalnym nagrobkiem; nieznane identyfikatory zwracają 404.GET /feeds/reviews.xml— najnowsze widoczne publikacje według pierwotnej daty utworzenia, najnowsze jako pierwsze. Domyślnie uwzględnia recenzje najwyższego poziomu.GET /api/v1/openapi.json— kontrakt OpenAPI 3.1 do odczytu maszynowego. Obsługiwane są HEAD i OPTIONS.
| Parametr | Oznaczający |
|---|---|
| cursor | Tylko lista JSON. Zacznij od 0; następnie użyj pagination.next_cursor dokładnie tak, jak zwrócono. Traktuj go jako nieprzezroczysty ciąg dziesiętny. |
| limit | 1–100. JSON domyślnie 50; RSS domyślnie 20. |
| type | wszystko, przejrzyj lub odpowiedz. JSON domyślnie wszystkie; RSS domyślna recenzja. |
| company_id | Stabilny identyfikator usługi; zalecane do długotrwałej synchronizacji. Prawidłowy identyfikator bez pasujących rekordów zwraca pustą listę. |
| service | Bieżący błąd serwisowy, np. mieszanka. Użyj usługi lub identyfikatora firmy. Nieznane ślimaki zwracają 404. Ślimaki mogą się zmieniać; Identyfikatory są stabilne. |
Nieznane, zduplikowane lub nieprawidłowe parametry zwracają HTTP 400. Filtrowanie wykorzystuje usługę i typ rekordu; znaczniki usunięcia zachowują te wewnętrzne klucze filtrów, ale nie ujawniają żadnej starej zawartości.
Pełne archiwum, aktualizacje i usunięcia
- Zacznij od
cursor=0. Dodaj opublikowane rekordy doglobal_id; usuń kopie lokalne, gdystatus=deleted. - Podążaj
pagination.next_urlaż dohas_more=false. Nie zgaduj ani nie zwiększaj wartości kursora. - Utrzymuj
next_cursordopiero po pomyślnym zastosowaniu tej strony. Odpytuj ponownie za pomocą zapisanego kursora, zwykle co 1–5 minut. - Zachowaj osobne kursory dla każdego filtra. Zmiana filtrów wymaga rozpoczęcia od 0 i uzgodnienia odpowiedniego lokalnego zbioru danych.
{
"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.Projekcja sprawdza udostępnione dane publiczne najwyżej raz na pięć sekund. Śledzi edytowany tekst, wyniki, tagi, autorów, linki do usług, oficjalny status i głosy w komentarzach. Wiele edycji pomiędzy sprawdzeniami może połączyć się w jeden ostatni stan: jest to synchronizacja, a nie archiwum historii edycji.
Usunięcie, trwałe usunięcie, niepublikowanie usługi lub wykluczenie zaimportowanego wątku zastępuje wcześniej wyeksportowany zapis minimalnym nagrobkiem. Stary tekst oraz ładunki autora/usługi zostaną usunięte z projekcji. usunięte_at rejestruje, kiedy podczas eksportu zaobserwowano usunięcie. Ponowna publikacja rekordu powoduje później opublikowaną wersję.
{
"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"
}Powtarzające się rekordy są normalne: zastosuj stan tylko wtedy, gdy jego wersja jest nowsza niż wersja lokalna. Po ustawieniu filtra plik danych może wyprzedzić niepowiązane wersje. Kursor przed serwerem zwraca 409, na przykład po przywróceniu: uruchom ponownie od 0 i uzgodnij, usuwając lokalne wpisy nieobecne w odbudowanym zbiorze danych. Zalecane jest również okresowe pełne uzgadnianie.
Eksportowane są tylko oryginalne wątki KYCLESS. Przyszły import jest oznaczany oddzielnie i wykluczany, aby uniknąć ponownego importu okrężnego. Akta usunięte przed wyeksportowaniem nie mają nagrobka eksportowego. Nagrobki wcześniej wyeksportowanych akt są zachowywane bez treści osobistych.
Pola danych publicznych
id / global_id
Stabilne struny. id jest lokalne; global_id (kycless:comment:123) ma globalną przestrzeń nazw. Nigdy nie deduplikuj według autora lub tekstu recenzji.
origin / status / type
origin to kycless. status to published lub deleted; type to review (najwyższy poziom, w tym nieocenione starsze recenzje) lub reply.
revision / exported_at
Wersja eksportu monotonicznego (ciąg dziesiętny) i czas UTC zmiany stanu eksportu. Zmiany w metadanych i komentarzach-głosach również powodują nową wersję.
url / parent_id / root_review_id
Oryginalne zakończenie bezpośredniego linku #comment-ID; bezpośredni rodzic (null dla katalogu głównego) i identyfikator wątku głównego. Odpowiedzi mogą pozostać widoczne po usunięciu ich katalogu głównego.
title / display_title / title_is_generated
KYCLESS nie ma obecnie osobnego tytułu recenzji: title to null. display_title to wygenerowany nagłówek kanału, wyraźnie oznaczony przez title_is_generated=true.
body.source / source_format
Oryginalny tekst publiczny ze znacznikami wbudowanymi KYCLESS; source_format to kycless-inline-v1. Obsługuje **bold**, *italic*, __underline__, ~~strike~~ i [label](https://example.org).
body.text / body.html
Zwykły tekst i bezpiecznie renderowany kod HTML ze znakami ucieczki. Użyj body.text do renderowania tekstu i body.html do renderowania sformatowanego. Dozwolone elementy HTML: strong, em, u, s, a i br. Linki używają HTTP(S) i rel=nofollow ugc noopener noreferrer.
rating
Obiekt {value,min:1,max:5} lub null, gdy nie ma oceny w gwiazdkach. Nie interpretuj null jako zerowej gwiazdki ani nie mieszaj liczby odpowiedzi z ocenami recenzji.
tags / votes
Publiczne kody znaczników, etykiety i ton; głosów w górę/w dół w sprawie tej konkretnej recenzji/komentarza. To nie są ogólne głosy w serwisie.
author
Stabilny identyfikator publiczny, pseudonim, adres URL profilu publicznego i avatar_url. display_name / display_avatar_url odzwierciedlają nazwę/logo usługi, aby uzyskać oficjalną odpowiedź. Rola konta, dane uwierzytelniające, adresy IP i aktywność prywatna są wykluczone.
is_official
true tylko w przypadku odpowiedzi w imieniu usługi udzielonej przez obecnego właściciela usługi. To nie jest płatna flaga promocyjna.
company
Stabilny identyfikator, bieżący ślimak/nazwa, adres URL karty serwisowej KYCLESS, logo, główna witryna Clearnet i wszystkie łącza do sieci publicznej. Brak danych administracyjnych lub danych źródłowych.
created_at / updated_at
Oryginalne czasy edycji publikacji i recenzji jako ciągi znaków ISO 8601 UTC. Zmiany metadanych są śledzone przez revision / exported_at, niekoniecznie updated_at.
order_proof_masked / attachments
Tylko ten sam zamaskowany numer zamówienia jest pokazywany publicznie. Pełne referencje zamówień nigdy nie są eksportowane. Recenzje obecnie nie mają załączników; attachments jest pustą tablicą.
Definicje pól, dopuszczalność wartości null i schematy odpowiedzi są dostępne w OtwórzAPI. Puste wartości pozostają null lub puste tablice. Identyfikatory i wersje to ciągi znaków; znaczniki czasu używają czasu UTC. Oddzielne nagłówki recenzji i załączniki plików nie są obecnie częścią produktu.
RSS kanał
RSS 2.0 domyślnie udostępnia 20 ostatnich widocznych recenzji (do 100). Każdy element zawiera stabilny identyfikator GUID, oryginalny link bezpośredni, wygenerowany nagłówek, datę publikacji, bezpieczny opis HTML, sformatowaną treść i wyświetlaną nazwę autora za pomocą dc:creator.
content:encoded zawiera tekst w pełnym formacie oraz linki do autora, serwisu i oryginalnej recenzji. Przestrzeń nazw kycless: zawiera identyfikatory, wersję, typ, pochodzenie, identyfikatory nadrzędne/główne, ocenę, linki do usług i autorów, oficjalny status, czas aktualizacji i szczegółowy adres URL JSON. Publiczne kody znaczników są zawarte w RSS kategoriach.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100RSS to kanał z najnowszymi publikacjami, a nie pełny kanał archiwum lub usuwania. Identyfikatory GUID pozostają niezmienne podczas edycji, a daty publikacji zachowują swoje pierwotne znaczenie. Użyj kursora API, aby wiarygodnie aktualizować stare rekordy i usuwać usunięte.
Buforowanie, błędy i limity użytkowania
API i kanał dzielą limit 120 żądań/minutę na adres IP, w tym żądania HEAD i żądania warunkowe. Obowiązują również istniejące limity serii obejmujące całą witrynę: wysyłaj żądania sekwencyjnie, unikaj serii i odpytuj co 1–5 minut. Na 429 lub 503 przestrzegaj Retry-After. OPTIONS i dokument OpenAPI nie zużywają limitu eksportu.
Odpowiedzi obsługują ETag. Wyślij If-None-Match z ostatnią odpowiedzią ETag, aby otrzymać bez zmian HTTP 304. RSS obsługuje także ostatnią modyfikację / jeśli-modyfikacja-od; preferuj ETag do precyzyjnego wykrywania zmian. CORS umożliwia odczyt z przeglądarki publicznej bez poświadczeń. Nieobsługiwane metody zapisu zwracają 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'Wersja 1 utrzymuje istniejące znaczenia pól na stabilnym poziomie. Można dodać dodatkowe opcjonalne pola; zignoruj pola, których nie rozpoznajesz. Najważniejsze zmiany wymagają nowej wersji API. Zachowaj adres URL punktu końcowego i stan kursora w konfiguracji integracji.
Gotowy do uruchomienia klient Python
Klient biblioteki standardowej utrzymuje dedykowaną kopię lustrzaną SQLite, obsługuje paginację kursora, wstawianie, usuwanie, opóźnienia ponownych prób i resetowanie 409. Zatwierdza dane lokalne i kursor atomowo; nieudane przebiegi cofają się. Nie są potrzebne żadne zewnętrzne pakiety Pythona ani klucz API.
Pobierz 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 --fullUruchamiaj go co 1–5 minut. Każdy plik SQLite należy do jednego zakresu filtra; zmiana filtra lub użycie --full odbudowuje dedykowane lustro. Dostosuj tę samą logikę wstawiania/usuwania podczas przechowywania danych we własnej aplikacji.
OpenAPI, referencje i kontakt
Specyfikacja OpenAPI 3.1 JSON dokumentuje wszystkie punkty końcowe i warianty odpowiedzi dla wygenerowanych klientów oraz walidację.
Odniesienia w formacie: Specyfikacja RSS 2.0, HTTP semantyka.
W przypadku pytań dotyczących integracji lub większego limitu żądań użyj kanały kontaktu KYCLESS.