Zum Inhalt springen
Entwickler

KYCLESS Bewertungen API & RSS

Ursprüngliche öffentliche Rezensionen, Antworten und Service-Metadaten. Ein vollständiges Archiv und zuverlässige Updates, ohne Scraping. Kein Konto oder API-Schlüssel erforderlich.

Schnellstart

Verwenden Sie JSON API für einen vollständigen Spiegel. Verwenden Sie RSS, um aktuelle Veröffentlichungen anzuzeigen. Beide werden aus demselben öffentlichen Datensatz generiert. Alle Anfragen sind schreibgeschützt.

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'

Ordnen Sie Datensätze KYCLESS zu, behalten Sie den Autor bei und verlinken Sie zurück zu url. Sorgen Sie dafür, dass importierte Bewertungen von direkt auf Ihrer Plattform veröffentlichten Bewertungen unterscheidbar sind.

Endpunkte und Filter

  • GET /api/v1/reviews – Archiv und Änderungen, in aufsteigender Exportrevisionsreihenfolge. Standard umfasst sowohl Bewertungen als auch Antworten.
  • GET /api/v1/reviews/123 – ein Datensatz. Bekannte entfernte Datensätze geben HTTP 410 mit einem minimalen Grabstein zurück; Unbekannte IDs geben 404 zurück.
  • GET /feeds/reviews.xml – Neueste sichtbare Veröffentlichungen nach ursprünglichem Erstellungsdatum, neueste zuerst. Die Standardeinstellung umfasst Bewertungen der obersten Ebene.
  • GET /api/v1/openapi.json – maschinenlesbarer OpenAPI 3.1-Vertrag. HEAD und OPTIONS werden unterstützt.
ParameterBedeutung
cursorNur JSON Liste. Beginnen Sie bei 0; Verwenden Sie dann pagination.next_cursor genau wie zurückgegeben. Behandeln Sie es als undurchsichtige Dezimalzeichenfolge.
limit1–100. JSON Standard 50; RSS Standard 20.
typeAlle, Bewertung oder Antwort. JSON Standard alle; RSS Standardbewertung.
company_idStabile Dienst-ID; Empfohlen für eine langlebige Synchronisierung. Eine gültige ID ohne übereinstimmende Datensätze gibt eine leere Liste zurück.
serviceAktueller Service-Slug, z.B. Mixtum. Verwenden Sie entweder service oder company_id. Unbekannte Slugs geben 404 zurück. Slugs können sich ändern; IDs sind stabil.

Unbekannte, doppelte oder ungültige Parameter geben HTTP 400 zurück. Beim Filtern werden der Dienst und Typ des Datensatzes verwendet. Löschmarkierungen behalten diese internen Filterschlüssel bei, legen aber keinen alten Inhalt offen.

Komplettes Archiv, Aktualisierungen und Löschungen

  1. Beginnen Sie mit cursor=0. Veröffentlichte Datensätze um global_id hochladen; Lokale Kopien entfernen, wenn status=deleted.
  2. Folgen Sie pagination.next_url bis has_more=false. Erraten oder erhöhen Sie keine Cursorwerte.
  3. Bleiben Sie next_cursor erst bestehen, nachdem diese Seite erfolgreich angewendet wurde. Führen Sie eine erneute Umfrage mit dem gespeicherten Cursor durch, normalerweise alle 1–5 Minuten.
  4. Behalten Sie separate Cursor pro Filter bei. Das Ändern von Filtern erfordert, bei 0 zu beginnen und den entsprechenden lokalen Datensatz abzugleichen.
{
  "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.

Die Projektion überprüft die öffentlichen Daten höchstens einmal alle fünf Sekunden. Es verfolgt bearbeitete Texte, Partituren, Tags, Autoren, Service-Links, offiziellen Status und Kommentarstimmen. Mehrere Bearbeitungen zwischen Prüfungen können zu einem aktuellen Stand zusammenlaufen: Es handelt sich dabei um eine Synchronisierung, nicht um ein Bearbeitungsverlaufsarchiv.

Durch das Löschen, das endgültige Löschen, die Aufhebung der Dienstveröffentlichung oder den Ausschluss eines importierten Threads wird ein zuvor exportierter Datensatz durch einen minimalen Tombstone ersetzt. Alte Text- und Autoren-/Dienstnutzlasten werden aus der Projektion entfernt. delete_at zeichnet auf, wann beim Export eine Entfernung beobachtet wurde. Durch die erneute Veröffentlichung des Datensatzes wird eine später veröffentlichte Revision erstellt.

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

Wiederholte Datensätze sind normal: Wenden Sie einen Status nur an, wenn seine Revision neuer als Ihre lokale Revision ist. Wenn ein Filter festgelegt ist, kann der Feed über unabhängige Revisionen hinausgehen. Ein Cursor vor dem Server gibt 409 zurück, zum Beispiel nach einer Wiederherstellung: Bei 0 neu starten und abgleichen, wobei lokale Einträge entfernt werden, die im neu erstellten Datensatz fehlen. Darüber hinaus wird ein regelmäßiger vollständiger Abgleich empfohlen.

Es werden nur Original-KYCLESS-Threads exportiert. Zukünftige Importe werden gesondert gekennzeichnet und ausgeschlossen, um zirkuläre Reimporte zu vermeiden. Ein Datensatz, der vor dem Export entfernt wurde, weist keinen Export-Tombstone auf. Tombstones für zuvor exportierte Datensätze bleiben ohne persönlichen Inhalt erhalten.

Öffentliche Datenfelder

id / global_id

Stabile Saiten. id ist lokal; global_id (kycless:comment:123) hat einen globalen Namensraum. Deduplizieren Sie niemals nach Autor oder Rezensionstext.

origin / status / type

origin ist kycless. status ist published oder deleted; type ist review (höchstes Niveau, einschließlich nicht bewerteter älterer Bewertungen) oder reply.

revision / exported_at

Monotone Exportrevision (Dezimalzeichenfolge) und UTC-Zeit, als sich dieser Exportstatus änderte. Metadaten- und Kommentar-Abstimmungsänderungen führen ebenfalls zu einer neuen Revision.

url / parent_id / root_review_id

Ursprünglicher Permalink mit der Endung #comment-ID; direkter übergeordneter Thread (null für einen Root) und Root-Thread-ID. Antworten können auch nach dem Löschen ihres Stammverzeichnisses sichtbar bleiben.

title / display_title / title_is_generated

KYCLESS hat derzeit keinen separaten Rezensionstitel: title ist null. display_title ist eine generierte Feed-Überschrift, die explizit durch title_is_generated=true gekennzeichnet ist.

body.source / source_format

Ursprünglicher öffentlicher Text mit KYCLESS Inline-Markup; source_format ist kycless-inline-v1. Unterstützt **bold**, *italic*, __underline__, ~~strike~~ und [label](https://example.org).

body.text / body.html

Einfacher Text und maskiertes, sicher gerendertes HTML. Verwenden Sie body.text für die Textwiedergabe und body.html für die formatierte Wiedergabe. Zulässige HTML-Elemente: strong, em, u, s, a und br. Links verwenden HTTP(S) und rel=nofollow ugc noopener noreferrer.

rating

Objekt {value,min:1,max:5} oder null, wenn keine Sternebewertung vorhanden ist. Interpretieren Sie null nicht als Null-Sterne oder vermischen Sie die Anzahl der Antworten mit den Bewertungsbewertungen.

tags / votes

Öffentliche Tag-Codes, Beschriftungen und Ton; Up/Down-Stimmen für diese spezifische Rezension/Kommentar. Dies sind nicht die Gesamtstimmen des Dienstes.

author

Stabile öffentliche ID, Spitzname, öffentliche Profil-URL und avatar_url. display_name / display_avatar_url geben den Namen/das Logo des Dienstes für eine offizielle Antwort wieder. Kontorolle, Anmeldeinformationen, IPs und private Aktivitäten sind ausgeschlossen.

is_official

true nur für eine Antwort im Namen des Dienstes durch einen aktuellen Dienstinhaber. Es handelt sich nicht um eine kostenpflichtige Werbeflagge.

company

Stabile ID, aktueller Slug/Name, KYCLESS Dienstkarten-URL, Logo, primäre Clearnet-Website und alle öffentlichen Netzwerklinks. Keine Administrator- oder Feed-Anmeldeinformationen.

created_at / updated_at

Bearbeitungszeiten der Originalveröffentlichung und Rezension als ISO 8601 UTC-Strings. Metadatenänderungen werden von revision / exported_at verfolgt, nicht unbedingt von updated_at.

order_proof_masked / attachments

Nur die gleiche maskierte Bestellreferenz wird öffentlich angezeigt. Vollständige Bestellreferenzen werden niemals exportiert. Bewertungen haben derzeit keine Anhänge; attachments ist ein leeres Array.

Felddefinitionen, Nullfähigkeit und Antwortschemata sind in OpenAPI verfügbar. Leere Werte bleiben Null oder leere Arrays. IDs und Revisionen sind Zeichenfolgen; Zeitstempel verwenden UTC. Separate Rezensionsüberschriften und Dateianhänge sind derzeit nicht Bestandteil des Produkts.

RSS Futter

RSS 2.0 bietet standardmäßig die neuesten 20 sichtbaren Bewertungen (bis zu 100). Jedes Element enthält eine stabile GUID, einen Original-Permalink, eine generierte Überschrift, ein Veröffentlichungsdatum, eine sichere HTML-Beschreibung, einen formatierten Inhalt und einen Anzeigenamen des Autors über dc:creator.

content:encoded enthält den vollständigen formatierten Text und Links zum Autor, zum Dienst und zur Originalrezension. Der kycless:-Namespace liefert IDs, Revision, Typ, Herkunft, übergeordnete/Stamm-IDs, Bewertung, Dienst- und Autorenlinks, offiziellen Status, Aktualisierungszeit und die JSON-Detail-URL. Öffentliche Tag-Codes sind als RSS Kategorien enthalten.

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 ist ein Feed mit aktuellen Veröffentlichungen, nicht das vollständige Archiv oder der Löschkanal. GUIDs bleiben über Bearbeitungen hinweg stabil und Veröffentlichungsdaten behalten ihre ursprüngliche Bedeutung. Verwenden Sie den API-Cursor, um alte Datensätze zuverlässig zu aktualisieren und gelöschte zu entfernen.

Caching, Fehler und Nutzungsbeschränkungen

API und Feed teilen ein Limit von 120 Anfragen/Minute pro IP, einschließlich HEAD und bedingter Anfragen. Es gelten auch die bestehenden standortweiten Burst-Limits: Senden Sie Anfragen nacheinander, vermeiden Sie Bursts und fragen Sie alle 1–5 Minuten ab. Bei 429 oder 503 befolgen Sie Retry-After. OPTIONS und das OpenAPI-Dokument verbrauchen nicht das exportspezifische Kontingent.

Antworten unterstützen ETag. Senden Sie If-None-Match mit dem letzten Antwort-ETag, um bei unveränderter Form ein körperfreies HTTP 304 zu erhalten. RSS unterstützt auch Last-Modified / If-Modified-Since; Bevorzugen Sie ETag für eine präzise Änderungserkennung. CORS ermöglicht das Lesen öffentlicher Browser ohne Anmeldeinformationen. Nicht unterstützte Schreibmethoden geben 405 zurück.

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'

Version 1 hält die vorhandenen Feldbedeutungen stabil. Es können zusätzliche optionale Felder hinzugefügt werden; Ignorieren Sie Felder, die Sie nicht kennen. Wichtige Änderungen erfordern eine neue API-Version. Behalten Sie die Endpunkt-URL und den Cursorstatus in Ihrer Integrationskonfiguration bei.

Bereit zum Ausführen des Python-Clients

Der Standardbibliotheksclient unterhält einen dedizierten SQLite-Spiegel, kümmert sich um Cursor-Paginierung, Upserts, Löschungen, Wiederholungsverzögerungen und einen 409-Reset. Lokale Daten und der Cursor werden atomar festgeschrieben. Fehlgeschlagene Läufe werden zurückgesetzt. Es sind keine externen Python-Pakete oder der Schlüssel API erforderlich.

kycless_reviews_sync.py herunterladen
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

Führen Sie es alle 1–5 Minuten aus. Jede SQLite-Datei gehört zu einem Filterbereich; Wenn Sie den Filter ändern oder --full verwenden, wird der dedizierte Spiegel neu erstellt. Passen Sie die gleiche Upsert-/Löschlogik an, wenn Sie Daten in Ihrer eigenen Anwendung speichern.

OpenAPI, Referenzen & Kontakt

OpenAPI 3.1 JSON Spezifikation dokumentiert alle Endpunkte und Antwortvarianten für generierte Clients und Validierung.

Formatverweise: RSS 2.0 Spezifikation, HTTP Semantik.

Für Integrationsfragen oder eine höhere Anfragequote verwenden Sie die KYCLESS Kontaktkanäle.