Avvio rapido
Usa JSON API per uno specchio completo. Utilizzare RSS per visualizzare le pubblicazioni recenti. Entrambi sono generati dallo stesso set di dati pubblico. Tutte le richieste sono di sola lettura.
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'Attribuisci i record a KYCLESS, preserva l'autore e ricollega a url. Mantieni le recensioni importate distinguibili dalle recensioni pubblicate direttamente sulla tua piattaforma.
Endpoint e filtri
GET /api/v1/reviews: archivio e modifiche, in ordine crescente di revisione dell'esportazione. L'impostazione predefinita include sia le recensioni che le risposte.GET /api/v1/reviews/123: un record. I record rimossi noti restituiscono HTTP 410 con una lapide minima; gli ID sconosciuti restituiscono 404.GET /feeds/reviews.xml: ultime pubblicazioni visibili per data di creazione originale, prima la più recente. L'impostazione predefinita include le revisioni di primo livello.GET /api/v1/openapi.json: contratto OpenAPI 3.1 leggibile dalla macchina. HEAD e OPZIONI sono supportati.
| Parametro | Senso |
|---|---|
| cursor | Solo elenco JSON. Inizia da 0; quindi utilizzare pagination.next_cursor esattamente come restituito. Trattalo come una stringa decimale opaca. |
| limit | 1–100. JSON predefinito 50; RSS predefinito 20. |
| type | tutto, rivedi o rispondi. JSON predefinito tutto; RSS revisione predefinita. |
| company_id | ID servizio stabile; consigliato per una sincronizzazione di lunga durata. Un ID valido senza record corrispondenti restituisce un elenco vuoto. |
| service | Slug di servizio attuale, ad es. mixtum. Utilizza service o company_id. Gli slug sconosciuti restituiscono 404. Gli slug possono cambiare; Gli ID sono stabili. |
I parametri sconosciuti, duplicati o non validi restituiscono HTTP 400. Il filtraggio utilizza il servizio e il tipo del record; i marcatori di eliminazione mantengono le chiavi di filtro interne ma non espongono vecchi contenuti.
Archivio completo, aggiornamenti ed eliminazioni
- Inizia con
cursor=0. Aggiorna i record pubblicati daglobal_id; rimuovi le copie locali quandostatus=deleted. - Segui
pagination.next_urlfino ahas_more=false. Non indovinare o incrementare i valori del cursore. - Persisti
next_cursorsolo dopo aver applicato con successo quella pagina. Effettua nuovamente il sondaggio con il cursore salvato, normalmente ogni 1–5 minuti. - Mantieni cursori separati per filtro. La modifica dei filtri richiede l'avvio da 0 e la riconciliazione del set di dati locale corrispondente.
{
"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.La proiezione controlla i dati pubblici impegnati al massimo una volta ogni cinque secondi. Tiene traccia del testo modificato, dei punteggi, dei tag, degli autori, dei collegamenti ai servizi, dello stato ufficiale e dei voti dei commenti. Molteplici modifiche tra i controlli possono confluire in un ultimo stato: questa è la sincronizzazione, non un archivio della cronologia delle modifiche.
L'eliminazione, l'eliminazione definitiva, la disattivazione del servizio o l'esclusione di un thread importato sostituiscono un record precedentemente esportato con una rimozione minima. Il vecchio testo e i payload dell'autore/servizio vengono rimossi dalla proiezione. delete_at registra il momento in cui l'esportazione ha rilevato la rimozione. La ripubblicazione del record produce una revisione pubblicata successivamente.
{
"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"
}I record ripetuti sono normali: applica uno stato solo quando la sua revisione è più recente della tua revisione locale. Il feed può avanzare oltre le revisioni non correlate quando viene impostato un filtro. Un cursore davanti al server restituisce 409, ad esempio dopo un ripristino: riavviare da 0 e riconciliare, rimuovendo le voci locali assenti dal set di dati ricostruito. Si consiglia inoltre una riconciliazione completa periodica.
Vengono esportati solo i thread KYCLESS originali. Le future importazioni sono contrassegnate separatamente ed escluse per evitare reimportazioni circolari. Un record rimosso prima di essere esportato non ha una rimozione definitiva per l'esportazione. Gli oggetti contrassegnati per rimozione definitiva per i record precedentemente esportati vengono conservati senza contenuto personale.
Campi dati pubblici
id / global_id
Corde stabili. id è locale; global_id (kycless:comment:123) ha uno spazio dei nomi globale. Non deduplicare mai per autore o rivedere il testo.
origin / status / type
origin è kycless. status è published o deleted; type è review (livello superiore, comprese le recensioni precedenti senza classificazione) o reply.
revision / exported_at
Revisione dell'esportazione monotona (stringa decimale) e ora UTC in cui lo stato di esportazione è cambiato. Anche le modifiche ai metadati e ai voti nei commenti producono una nuova revisione.
url / parent_id / root_review_id
Fine del permalink originale #comment-ID; genitore diretto (null per una radice) e ID del thread radice. Le risposte possono rimanere visibili dopo che la loro radice è stata eliminata.
title / display_title / title_is_generated
KYCLESS attualmente non ha un titolo di recensione separato: title è null. display_title è un'intestazione di feed generata, contrassegnata esplicitamente da title_is_generated=true.
body.source / source_format
Testo pubblico originale con markup in linea KYCLESS; source_format è kycless-inline-v1. Supporta **bold**, *italic*, __underline__, ~~strike~~ e [label](https://example.org).
body.text / body.html
Testo semplice e HTML con escape e rendering sicuro. Utilizza body.text per il rendering del testo e body.html per il rendering formattato. Elementi HTML consentiti: strong, em, u, s, a e br. I collegamenti utilizzano HTTP(S) e rel=nofollow ugc noopener noreferrer.
rating
Oggetto {value,min:1,max:5} o null quando non esiste una valutazione in stelle. Non interpretare null come zero stelle e non mescolare il conteggio delle risposte con le valutazioni delle recensioni.
tags / votes
Codici, etichette e toni dei tag pubblici; voti su/giù su questa recensione/commento specifico. Questi non sono i voti complessivi del servizio.
author
ID pubblico stabile, nickname, URL del profilo pubblico e avatar_url. display_name / display_avatar_url riflettono il nome/logo del servizio per una risposta ufficiale. Sono esclusi il ruolo dell'account, le credenziali, gli IP e l'attività privata.
is_official
true solo per una risposta per conto del servizio da parte dell'attuale titolare del servizio. Non è un flag di promozione a pagamento.
company
ID stabile, slug/nome corrente, URL della scheda di servizio KYCLESS, logo, sito Web Clearnet principale e tutti i collegamenti di rete pubblica. Nessuna credenziale amministrativa o feed.
created_at / updated_at
Pubblicazione originale e tempi di modifica della revisione come stringhe ISO 8601 UTC. Le modifiche ai metadati vengono tracciate da revision / exported_at, non necessariamente updated_at.
order_proof_masked / attachments
Solo lo stesso riferimento all'ordine mascherato mostrato pubblicamente. I riferimenti completi agli ordini non vengono mai esportati. Le recensioni al momento non hanno allegati; attachments è un array vuoto.
Le definizioni dei campi, l'annullamento dei valori nulli e gli schemi di risposta sono disponibili in OpenAPI. I valori vuoti rimangono array nulli o vuoti. Gli ID e le revisioni sono stringhe; i timestamp utilizzano UTC. Intestazioni di revisione separate e file allegati non fanno attualmente parte del prodotto.
RSS alimentazione
RSS 2.0 fornisce per impostazione predefinita le ultime 20 recensioni visibili (fino a 100). Ogni elemento contiene un GUID stabile, un permalink originale, un'intestazione generata, una data di pubblicazione, una descrizione HTML sicura, un contenuto formattato e un nome visualizzato dell'autore tramite dc:creator.
content:encoded include il testo formattato completo e collegamenti all'autore, al servizio e alla recensione originale. Lo spazio dei nomi kycless: fornisce ID, revisione, tipo, origine, ID genitore/root, valutazione, collegamenti al servizio e all'autore, stato ufficiale, ora di aggiornamento e URL di dettaglio JSON. I codici dei tag pubblici sono inclusi come RSS categorie.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100RSS è un feed delle pubblicazioni recenti, non l'archivio completo o il canale di eliminazione. I GUID rimangono stabili durante le modifiche e le date di pubblicazione mantengono il loro significato originale. Utilizza il cursore API per aggiornare in modo affidabile i vecchi record e rimuovere quelli eliminati.
Caching, errori e limiti di utilizzo
API e feed condividono un limite di 120 richieste/minuto per IP, incluse HEAD e richieste condizionali. Si applicano anche i limiti di burst esistenti a livello di sito: inviare richieste in sequenza, evitare burst ed eseguire poll ogni 1-5 minuti. Su 429 o 503 obbedisci a Retry-After. OPTIONS e il documento OpenAPI non consumano la quota specifica per l'esportazione.
Le risposte supportano ETag. Invia If-None-Match con l'ultima risposta ETag per ricevere un HTTP 304 senza corpo quando invariato. RSS supporta anche Last-Modified / If-Modified-Since; preferisci ETag per un rilevamento preciso delle modifiche. CORS consente la lettura del browser pubblico senza credenziali. I metodi di scrittura non supportati restituiscono 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'La versione 1 mantiene stabili i significati dei campi esistenti. Possono essere aggiunti ulteriori campi facoltativi; ignora i campi che non riconosci. Le modifiche importanti richiedono una nuova versione API. Mantieni l'URL dell'endpoint e lo stato del cursore nella configurazione di integrazione.
Client Python pronto per l'esecuzione
Il client della libreria standard mantiene un mirror SQLite dedicato, gestisce l'impaginazione del cursore, gli upsert, le eliminazioni, i ritardi tra i tentativi e un reset 409. Esegue il commit dei dati locali e del cursore in modo atomico; rollback delle esecuzioni non riuscite. Non sono necessari pacchetti Python esterni o chiave API.
Scarica 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 --fullEseguilo ogni 1-5 minuti. Ogni file SQLite appartiene a un ambito di filtro; cambiando il filtro o usando --full ricostruisce quel mirror dedicato. Adatta la stessa logica di inserimento/eliminazione durante l'archiviazione dei dati nella tua applicazione.
OpenAPI, riferimenti e contatti
Specifica OpenAPI 3.1 JSON documenta tutti gli endpoint e le varianti di risposta per i client generati e la convalida.
Riferimenti al formato: RSS Specifica 2.0, HTTP semantica.
Per domande sull'integrazione o una quota di richieste più elevata, utilizzare i KYCLESS canali di contatto.