Ga naar de inhoud
Ontwikkelaars

KYCLESS Recensies API & RSS

Originele openbare recensies, antwoorden en servicemetagegevens. Een compleet archief en betrouwbare updates, zonder scrappen. Geen account of API sleutel vereist.

Snel beginnen

Gebruik JSON API voor een complete spiegel. Gebruik RSS om recente publicaties weer te geven. Beide worden gegenereerd op basis van dezelfde openbare dataset. Alle verzoeken zijn alleen-lezen.

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'

Ken records toe aan KYCLESS, behoud de auteur en link terug naar url. Zorg ervoor dat geïmporteerde recensies onderscheidend zijn van recensies die rechtstreeks op uw platform zijn geplaatst.

Eindpunten en filters

  • GET /api/v1/reviews — archief en wijzigingen, in oplopende volgorde van exportrevisies. Standaard omvat zowel beoordelingen als antwoorden.
  • GET /api/v1/reviews/123 — één record. Bekende verwijderde records retourneren HTTP 410 met een minimale grafsteen; onbekende ID's retourneren 404.
  • GET /feeds/reviews.xml — laatst zichtbare publicaties op oorspronkelijke aanmaakdatum, nieuwste eerst. Standaard bevat dit beoordelingen op het hoogste niveau.
  • GET /api/v1/openapi.json — machinaal leesbaar OpenAPI 3.1-contract. HEAD en OPTIONS worden ondersteund.
ParameterBetekenis
cursorAlleen JSON lijst. Begin bij 0; gebruik vervolgens paginering.next_cursor precies zoals geretourneerd. Behandel het als een ondoorzichtige decimale tekenreeks.
limit1–100. JSON standaard 50; RSS standaard 20.
typealles, bekijken of reageren. JSON standaard alles; RSS standaardbeoordeling.
company_idStabiele service-ID; aanbevolen voor langdurige synchronisatie. Een geldige ID zonder overeenkomende records retourneert een lege lijst.
serviceHuidige serviceslak, b.v. mixtum. Gebruik service of bedrijf_id. Onbekende naaktslakken retourneren 404. Naaktslakken kunnen veranderen; ID's zijn stabiel.

Onbekende, dubbele of ongeldige parameters retourneren HTTP 400. Bij het filteren worden de service en het type van de record gebruikt; verwijderingsmarkeringen behouden die interne filtersleutels, maar laten geen oude inhoud zien.

Compleet archief, updates en verwijderingen

  1. Begin met cursor=0. Upsert gepubliceerde records door global_id; verwijder lokale kopieën wanneer status=deleted.
  2. Volg pagination.next_url tot has_more=false. Raad de cursorwaarden niet en verhoog deze niet.
  3. Blijf next_cursor alleen volhouden nadat u die pagina succesvol hebt toegepast. Voer opnieuw een peiling uit met de opgeslagen cursor, normaal gesproken elke 1-5 minuten.
  4. Houd aparte cursors per filter. Het wijzigen van filters vereist dat u begint vanaf 0 en dat u de bijbehorende lokale gegevensset op elkaar afstemt.
{
  "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.

Bij de projectiecontrole worden vastgelegde openbare gegevens maximaal één keer per vijf seconden gecontroleerd. Het houdt bewerkte tekst, scores, tags, auteurs, servicelinks, officiële status en commentaarstemmen bij. Meerdere bewerkingen tussen controles kunnen samensmelten tot één laatste status: dit is synchronisatie, geen archief met bewerkingsgeschiedenis.

Door het verwijderen, hard verwijderen, het niet publiceren van de service of het uitsluiten van een geïmporteerde thread wordt een eerder geëxporteerd record vervangen door een minimale tombstone. Oude tekst en auteurs-/servicepayloads worden uit de projectie verwijderd. delete_at registreert wanneer bij de export verwijdering werd waargenomen. Als u het record opnieuw publiceert, ontstaat er een later gepubliceerde revisie.

{
  "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"
}

Herhaalde records zijn normaal: pas een status alleen toe als de revisie nieuwer is dan uw lokale revisie. De feed kan voorbij niet-gerelateerde revisies gaan als er een filter is ingesteld. Een cursor vóór de server retourneert 409, bijvoorbeeld na een herstel: opnieuw opstarten op 0 en afstemmen, waarbij lokale vermeldingen worden verwijderd die ontbreken in de opnieuw opgebouwde dataset. Periodieke volledige afstemming wordt eveneens aanbevolen.

Alleen originele KYCLESS threads worden geëxporteerd. Toekomstige importen worden apart gemarkeerd en uitgesloten om circulaire wederimport te voorkomen. Een record dat is verwijderd voordat het ooit werd geëxporteerd, heeft geen exportgrafsteen. Grafstenen voor eerder geëxporteerde records worden bewaard zonder persoonlijke inhoud.

Openbare gegevensvelden

id / global_id

Stabiele snaren. id is lokaal; global_id (kycless:comment:123) heeft een globale naamruimte. Ontdubbel nooit op auteur of recensietekst.

origin / status / type

origin is kycless. status is published of deleted; type is review (hoogste niveau, inclusief niet-beoordeelde oudere beoordelingen) of reply.

revision / exported_at

Monotone exportrevisie (decimale tekenreeks) en UTC-tijd waarop deze geëxporteerde status veranderde. Metagegevens en wijzigingen in commentaar en stemmen resulteren ook in een nieuwe revisie.

url / parent_id / root_review_id

Originele permalink eindigend op #comment-ID; directe ouder (null voor een root) en rootthread-ID. Antwoorden kunnen zichtbaar blijven nadat de root is verwijderd.

title / display_title / title_is_generated

KYCLESS heeft momenteel geen aparte recensietitel: title is null. display_title is een gegenereerde feedkop, expliciet gemarkeerd met title_is_generated=true.

body.source / source_format

Originele openbare tekst met KYCLESS inline markup; source_format is kycless-inline-v1. Ondersteunt **bold**, *italic*, __underline__, ~~strike~~ en [label](https://example.org).

body.text / body.html

Platte tekst en ontsnapte, veilig weergegeven HTML. Gebruik body.text voor tekstweergave en body.html voor opgemaakte weergave. Toegestane HTML-elementen: strong, em, u, s, a en br. Links gebruiken HTTP(S) en rel=nofollow ugc noopener noreferrer.

rating

Object {value,min:1,max:5}, of null als er geen sterbeoordeling bestaat. Interpreteer null niet als nul sterren en meng het aantal reacties niet met recensies.

tags / votes

Openbare tagcodes, labels en toon; omhoog/omlaag stemmen op deze specifieke recensie/opmerking. Dit zijn niet de totale stemmen van de dienst.

author

Stabiele openbare ID, bijnaam, openbare profiel-URL en avatar_url. display_name / display_avatar_url geeft de servicenaam/logo weer voor een officieel antwoord. Accountrol, inloggegevens, IP's en privéactiviteiten zijn uitgesloten.

is_official

true alleen voor een antwoord namens de service door een huidige service-eigenaar. Het is geen betaalde promotievlag.

company

Stabiele ID, huidige naaktslak/naam, KYCLESS servicekaart-URL, logo, primaire Clearnet-website en alle openbare netwerkkoppelingen. Geen administratieve of feedgegevens.

created_at / updated_at

Originele publicatie- en recensiebewerkingstijden als ISO 8601 UTC-reeksen. Wijzigingen in metadata worden bijgehouden met revision / exported_at, niet noodzakelijkerwijs met updated_at.

order_proof_masked / attachments

Alleen dezelfde gemaskeerde bestelreferentie wordt openbaar weergegeven. Volledige orderreferenties worden nooit geëxporteerd. Recensies hebben momenteel geen bijlagen; attachments is een lege array.

Velddefinities, nullability en responsschema's zijn beschikbaar in OpenAPI. Lege waarden blijven nul of lege matrices. ID's en revisies zijn tekenreeksen; tijdstempels gebruiken UTC. Afzonderlijke recensiekoppen en bestandsbijlagen maken momenteel geen deel uit van het product.

RSS voer

RSS 2.0 biedt standaard de laatste 20 zichtbare recensies (maximaal 100). Elk item bevat een stabiele GUID, originele permalink, gegenereerde kop, publicatiedatum, veilige HTML-beschrijving, opgemaakte inhoud en weergavenaam van de auteur via dc:creator.

content:encoded bevat de volledig opgemaakte tekst en links naar de auteur, service en originele recensie. De kycless: naamruimte levert ID's, revisie, type, oorsprong, bovenliggende/root-ID's, beoordeling, service- en auteurslinks, officiële status, updatetijd en de JSON detail-URL. Openbare tagcodes zijn opgenomen als RSS categorieën.

https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100

RSS is een feed met recente publicaties, niet het volledige archief- of verwijderingskanaal. GUID's blijven stabiel tijdens bewerkingen en publicatiedatums behouden hun oorspronkelijke betekenis. Gebruik de cursor API om op betrouwbare wijze oude records bij te werken en verwijderde records te verwijderen.

Caching, fouten en gebruikslimieten

API en feed delen een limiet van 120 verzoeken/minuut per IP, inclusief HEAD en voorwaardelijke verzoeken. Bestaande burst-limieten voor de hele site zijn ook van toepassing: stuur verzoeken opeenvolgend, vermijd bursts en poll elke 1-5 minuten. Op 429 of 503 gehoorzaamt u Retry-After. OPTIONS en het OpenAPI-document gebruiken het exportspecifieke quotum niet.

Reacties ondersteunen ETag. Stuur If-None-Match met de laatste reactie-ETag om een ​​lichaamsvrije HTTP 304 te ontvangen wanneer deze onveranderd blijft. RSS ondersteunt ook Last-Modified / If-Modified-Since; geef de voorkeur aan ETag voor nauwkeurige wijzigingsdetectie. CORS staat openbare browserlezingen toe zonder inloggegevens. Niet-ondersteunde schrijfmethoden retourneren 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'

Versie 1 houdt bestaande veldbetekenissen stabiel. Er kunnen extra optionele velden worden toegevoegd; negeer velden die u niet herkent. Voor het breken van wijzigingen is een nieuwe API versie vereist. Bewaar de eindpunt-URL en cursorstatus in uw integratieconfiguratie.

Kant-en-klare Python-client

De standaardbibliotheekclient onderhoudt een speciale SQLite-mirror, verwerkt cursorpaginering, upserts, verwijderingen, vertragingen bij nieuwe pogingen en een 409-reset. Het legt lokale gegevens en de cursor atomair vast; mislukte runs worden teruggedraaid. Er zijn geen externe Python-pakketten of API-sleutel nodig.

kycless_reviews_sync.py downloaden
python3 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 --full

Voer het elke 1-5 minuten uit. Elk SQLite-bestand behoort tot één filterbereik; door het filter te veranderen of --full te gebruiken, wordt de speciale spiegel opnieuw opgebouwd. Pas dezelfde upsert/delete-logica toe bij het opslaan van gegevens in uw eigen applicatie.

OpenAPI, referenties & contact

OpenAPI 3.1 JSON specificatie documenteert alle eindpunten en responsvarianten voor gegenereerde clients en validatie.

Formaatreferenties: RSS 2.0-specificatie, HTTP semantiek.

Voor integratievragen of een hoger verzoekquotum gebruikt u de KYCLESS contactkanalen.