Passer au contenu
Développeurs

KYCLESS Avis API & RSS

Avis publics originaux, réponses et métadonnées de service. Une archive complète et des mises à jour fiables, sans scraping. Aucun compte ni clé API requis.

Démarrage rapide

Utilisez le JSON API pour un miroir complet. Utilisez RSS pour afficher les publications récentes. Les deux sont générés à partir du même ensemble de données publiques. Toutes les demandes sont en lecture seule.

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'

Attribuez les enregistrements à KYCLESS, conservez l'auteur et créez un lien vers url. Gardez les avis importés distincts des avis publiés directement sur votre plateforme.

Points de terminaison et filtres

  • GET /api/v1/reviews — archives et modifications, par ordre croissant de révision d'exportation. La valeur par défaut inclut à la fois les avis et les réponses.
  • GET /api/v1/reviews/123 — un enregistrement. Les enregistrements supprimés connus renvoient HTTP 410 avec une pierre tombale minimale ; les identifiants inconnus renvoient 404.
  • GET /feeds/reviews.xml — dernières publications visibles par date de création originale, la plus récente en premier. La valeur par défaut inclut les avis de niveau supérieur.
  • GET /api/v1/openapi.json — contrat OpenAPI 3.1 lisible par machine. HEAD et OPTIONS sont pris en charge.
ParamètreSignification
cursorListe JSON uniquement. Commencez à 0 ; puis utilisez pagination.next_cursor exactement comme renvoyé. Traitez-le comme une chaîne décimale opaque.
limit1 à 100. JSON par défaut 50 ; RSS par défaut 20.
typetout, révisez ou répondez. JSON tout par défaut ; RSS avis par défaut.
company_idID de service stable ; recommandé pour une synchronisation de longue durée. Un identifiant valide sans enregistrement correspondant renvoie une liste vide.
serviceSlug de service actuel, par ex. mélange. Utilisez soit service, soit company_id. Les limaces inconnues renvoient 404. Les limaces peuvent changer ; Les identifiants sont stables.

Les paramètres inconnus, en double ou invalides renvoient HTTP 400. Le filtrage utilise le service et le type de l'enregistrement ; les marqueurs de suppression conservent ces clés de filtre internes mais n’exposent aucun ancien contenu.

Archive complète, mises à jour et suppressions

  1. Commencez par cursor=0. Insérer les enregistrements publiés avant le global_id ; supprimez les copies locales lorsque status=deleted.
  2. Suivez pagination.next_url jusqu'à has_more=false. Ne devinez pas et n’incrémentez pas les valeurs du curseur.
  3. Persistez next_cursor uniquement après avoir appliqué avec succès cette page. Interrogez à nouveau avec le curseur enregistré, normalement toutes les 1 à 5 minutes.
  4. Gardez des curseurs séparés par filtre. Changer les filtres nécessite de partir de 0 et de rapprocher l'ensemble de données local correspondant.
{
  "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 projection vérifie les données publiques validées au maximum une fois toutes les cinq secondes. Il suit le texte édité, les partitions, les balises, les auteurs, les liens de service, le statut officiel et les votes des commentaires. Plusieurs modifications entre les contrôles peuvent fusionner en un seul état le plus récent : il s'agit d'une synchronisation et non d'une archive d'historique des modifications.

La suppression, la suppression définitive, la dépublication du service ou l'exclusion d'un fil de discussion importé remplace un enregistrement précédemment exporté par une pierre tombale minimale. Les anciennes charges utiles de texte et d’auteur/service sont supprimées de la projection. delete_at enregistre le moment où l'exportation a observé la suppression. La republication du document produit une révision publiée ultérieurement.

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

Les enregistrements répétés sont normaux : appliquez un état uniquement lorsque sa révision est plus récente que votre révision locale. Le flux peut avancer au-delà des révisions non liées lorsqu'un filtre est défini. Un curseur devant le serveur renvoie 409, par exemple après une restauration : redémarrez à 0 et réconciliez, en supprimant les entrées locales absentes du jeu de données reconstruit. Un rapprochement complet périodique est également recommandé.

Seuls les fils de discussion KYCLESS originaux sont exportés. Les importations futures sont marquées séparément et exclues pour éviter les réimportations circulaires. Un enregistrement supprimé avant d’être exporté n’a pas de base d’exportation. Les pierres tombales des enregistrements précédemment exportés sont conservées sans contenu personnel.

Champs de données publiques

id / global_id

Cordes stables. id est local ; global_id (kycless:comment:123) est un espace de noms global. Ne jamais dédupliquer par auteur ou réviser le texte.

origin / status / type

origin est kycless. status est published ou deleted ; type est review (niveau supérieur, y compris les anciens avis non notés) ou reply.

revision / exported_at

Révision d'exportation monotone (chaîne décimale) et heure UTC à laquelle cet état exporté a changé. Les modifications des métadonnées et des commentaires-votes produisent également une nouvelle révision.

url / parent_id / root_review_id

Permalien original se terminant par #comment-ID ; parent direct (null pour une racine) et ID de thread racine. Les réponses peuvent rester visibles après la suppression de leur racine.

title / display_title / title_is_generated

KYCLESS n'a actuellement pas de titre d'avis distinct : title est null. display_title est un en-tête de flux généré, explicitement marqué par title_is_generated=true.

body.source / source_format

Texte public original avec balisage en ligne KYCLESS ; source_format est kycless-inline-v1. Prend en charge **bold**, *italic*, __underline__, ~~strike~~ et [label](https://example.org).

body.text / body.html

Texte brut et code HTML échappé et rendu en toute sécurité. Utilisez body.text pour le rendu du texte et body.html pour le rendu formaté. Éléments HTML autorisés : strong, em, u, s, a et br. Les liens utilisent HTTP(S) et rel=nofollow ugc noopener noreferrer.

rating

Objet {value,min:1,max:5}, ou null lorsqu'aucun nombre d'étoiles n'existe. N'interprétez pas null comme zéro étoile et ne mélangez pas le nombre de réponses avec les notes des avis.

tags / votes

Codes d'étiquettes publiques, étiquettes et tonalité ; votes haut/bas sur cet avis/commentaire spécifique. Ce ne sont pas les votes globaux du service.

author

ID public stable, surnom, URL du profil public et avatar_url. display_name / display_avatar_url reflètent le nom/logo du service pour une réponse officielle. Le rôle du compte, les informations d'identification, les adresses IP et l'activité privée sont exclus.

is_official

true uniquement pour une réponse au nom du service par un propriétaire actuel du service. Ce n'est pas un drapeau de promotion payant.

company

ID stable, slug/nom actuel, URL de la carte de service KYCLESS, logo, site Web Clearnet principal et tous les liens du réseau public. Aucune information d'identification administrative ou de flux.

created_at / updated_at

Heures de publication et de révision originales sous forme de chaînes ISO 8601 UTC. Les modifications des métadonnées sont suivies par revision / exported_at, pas nécessairement par updated_at.

order_proof_masked / attachments

Uniquement la même référence de commande masquée affichée publiquement. Les références complètes des commandes ne sont jamais exportées. Les avis ne contiennent actuellement aucune pièce jointe ; attachments est un tableau vide.

Les définitions de champs, la nullité et les schémas de réponse sont disponibles dans OuvrirAPI. Les valeurs vides restent nulles ou des tableaux vides. Les identifiants et les révisions sont des chaînes ; les horodatages utilisent UTC. Les titres de révision séparés et les pièces jointes ne font actuellement pas partie du produit.

RSS flux

RSS 2.0 fournit par défaut les 20 derniers avis visibles (jusqu'à 100). Chaque élément contient un GUID stable, un permalien original, un en-tête généré, une date de publication, une description HTML sécurisée, un contenu formaté et le nom d'affichage de l'auteur via dc:creator.

content:encoded inclut le texte complet formaté et des liens vers l'auteur, le service et la critique originale. L'espace de noms kycless: fournit les identifiants, la révision, le type, l'origine, les identifiants parent/racine, l'évaluation, les liens de service et d'auteur, le statut officiel, l'heure de mise à jour et l'URL de détail JSON. Les codes de balises publiques sont inclus sous forme de catégories RSS.

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 est un flux de publications récentes, et non le canal d'archivage ou de suppression complet. Les GUID restent stables au fil des modifications et les dates de publication conservent leur signification d'origine. Utilisez le curseur API pour mettre à jour de manière fiable les anciens enregistrements et supprimer ceux supprimés.

Mise en cache, erreurs et limites d'utilisation

API et le flux partagent une limite de 120 requêtes/minute par IP, y compris les requêtes HEAD et conditionnelles. Les limites de rafales existantes à l'échelle du site s'appliquent également : envoyez les requêtes de manière séquentielle, évitez les rafales et interrogez toutes les 1 à 5 minutes. Au 429 ou 503, obéissez au Retry-After. OPTIONS et le document OpenAPI ne consomment pas le quota spécifique à l'exportation.

Les réponses prennent en charge ETag. Envoyez If-None-Match avec la dernière réponse ETag pour recevoir un HTTP 304 sans corps lorsqu'il est inchangé. RSS prend également en charge Last-Modified / If-Modified-Since ; préférez ETag pour une détection précise des changements. CORS autorise les lectures du navigateur public sans informations d'identification. Les méthodes d'écriture non prises en charge renvoient 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 version 1 maintient la signification des champs existants stable. Des champs facultatifs supplémentaires peuvent être ajoutés ; ignorez les champs que vous ne reconnaissez pas. Les modifications avec rupture nécessitent une nouvelle version API. Conservez l'URL du point de terminaison et l'état du curseur dans votre configuration d'intégration.

Client Python prêt à fonctionner

Le client de bibliothèque standard gère un miroir SQLite dédié, gère la pagination du curseur, les upserts, les suppressions, les délais de nouvelle tentative et une réinitialisation 409. Il valide les données locales et le curseur de manière atomique ; les exécutions ayant échoué sont annulées. Aucun package Python externe ni clé API n'est nécessaire.

Télécharger kycless_reviews_sync.py
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

Exécutez-le toutes les 1 à 5 minutes. Chaque fichier SQLite appartient à une étendue de filtre ; changer le filtre ou utiliser --full reconstruit ce miroir dédié. Adaptez la même logique d'insertion/suppression lors du stockage des données dans votre propre application.

OpenAPI, références & contact

Spécification OpenAPI 3.1 JSON documente tous les points de terminaison et variantes de réponse pour les clients générés et la validation.

Références de format : RSS Spécification 2.0, HTTP sémantique.

Pour les questions d'intégration ou un quota de demandes plus élevé, utilisez les KYCLESS canaux de contact.