Inicio rápido
Utilice el JSON API para obtener un espejo completo. Utilice RSS para mostrar publicaciones recientes. Ambos se generan a partir del mismo conjunto de datos públicos. Todas las solicitudes son de solo lectura.
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'Atribuya registros a KYCLESS, conserve el autor y vincule nuevamente a url. Mantenga las reseñas importadas distinguibles de las reseñas publicadas directamente en su plataforma.
Puntos finales y filtros
GET /api/v1/reviews: archivo y cambios, en orden ascendente de revisión de exportación. El valor predeterminado incluye reseñas y respuestas.GET /api/v1/reviews/123— un registro. Los registros eliminados conocidos arrojan HTTP 410 con una lápida mínima; Las identificaciones desconocidas devuelven 404.GET /feeds/reviews.xml: últimas publicaciones visibles por fecha de creación original, las más recientes primero. El valor predeterminado incluye reseñas de nivel superior.GET /api/v1/openapi.json: contrato OpenAPI 3.1 legible por máquina. Se admiten HEAD y OPCIONES.
| Parámetro | Significado |
|---|---|
| cursor | JSON solo lista. Comience en 0; luego use pagination.next_cursor exactamente como se devuelve. Trátelo como una cadena decimal opaca. |
| limit | 1–100. JSON predeterminado 50; RSS predeterminado 20. |
| type | todos, revisar o responder. JSON predeterminado todo; RSS revisión predeterminada. |
| company_id | ID de servicio estable; Recomendado para una sincronización de larga duración. Una identificación válida sin registros coincidentes devuelve una lista vacía. |
| service | Slug de servicio actual, p.e. mixtum. Utilice service o company_id. Las babosas desconocidas devuelven 404. Las babosas pueden cambiar; Las identificaciones son estables. |
Los parámetros desconocidos, duplicados o no válidos devuelven HTTP 400. El filtrado utiliza el servicio y el tipo de registro; Los marcadores de eliminación conservan esas claves de filtro internas pero no exponen ningún contenido antiguo.
Archivo completo, actualizaciones y eliminaciones
- Comience con
cursor=0. Insertar registros publicados porglobal_id; elimine las copias locales cuandostatus=deleted. - Siga
pagination.next_urlhastahas_more=false. No adivine ni incremente los valores del cursor. - Persista
next_cursorsolo después de aplicar con éxito esa página. Vuelva a sondear con el cursor guardado, normalmente cada 1 a 5 minutos. - Mantenga cursores separados por filtro. Cambiar filtros requiere comenzar desde 0 y conciliar el conjunto de datos local correspondiente.
{
"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 proyección verifica los datos públicos comprometidos como máximo una vez cada cinco segundos. Realiza un seguimiento del texto editado, partituras, etiquetas, autores, enlaces de servicios, estado oficial y votos de comentarios. Varias ediciones entre comprobaciones pueden fusionarse en un estado más reciente: esto es sincronización, no un archivo de historial de ediciones.
La eliminación, la eliminación definitiva, la anulación de la publicación del servicio o la exclusión de un hilo importado reemplazan un registro exportado anteriormente con una lápida mínima. El texto antiguo y las cargas útiles de autor/servicio se eliminan de la proyección. registros eliminados_at cuando la exportación observó la eliminación. Volver a publicar el registro produce una revisión publicada posteriormente.
{
"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"
}Los registros repetidos son normales: aplique un estado solo cuando su revisión sea más reciente que su revisión local. El feed puede avanzar más allá de revisiones no relacionadas cuando se establece un filtro. Un cursor delante del servidor devuelve 409, por ejemplo, después de una restauración: reinicie en 0 y concilie, eliminando las entradas locales ausentes del conjunto de datos reconstruido. También se recomienda una conciliación total periódica.
Solo se exportan los hilos KYCLESS originales. Las importaciones futuras se marcan por separado y se excluyen para evitar reimportaciones circulares. Un registro eliminado antes de ser exportado no tiene lápida de exportación. Las lápidas de registros exportados previamente se conservan sin contenido personal.
Campos de datos públicos
id / global_id
Cuerdas estables. id es local; global_id (kycless:comment:123) tiene un espacio de nombres global. Nunca realice deduplicaciones por autor o texto de revisión.
origin / status / type
origin es kycless. status es published o deleted; type es review (nivel superior, incluidas reseñas heredadas no calificadas) o reply.
revision / exported_at
Revisión de exportación monótona (cadena decimal) y hora UTC en la que cambió este estado exportado. Los cambios de metadatos y votación de comentarios también producen una nueva revisión.
url / parent_id / root_review_id
Enlace permanente original que termina #comment-ID; padre directo (null para una raíz) e ID del hilo raíz. Las respuestas pueden permanecer visibles después de que se elimine su raíz.
title / display_title / title_is_generated
KYCLESS actualmente no tiene un título de revisión separado: title es null. display_title es un encabezado de feed generado, marcado explícitamente con title_is_generated=true.
body.source / source_format
Texto público original con marcado en línea KYCLESS; source_format es kycless-inline-v1. Soporta **bold**, *italic*, __underline__, ~~strike~~ y [label](https://example.org).
body.text / body.html
Texto sin formato y HTML con formato de escape y renderizado de forma segura. Utilice body.text para renderizar texto y body.html para renderizar formato. Elementos HTML permitidos: strong, em, u, s, a y br. Los enlaces utilizan HTTP(S) y rel=nofollow ugc noopener noreferrer.
rating
Objeto {value,min:1,max:5} o null cuando no existe una calificación de estrellas. No interprete null como cero estrellas ni mezcle el recuento de respuestas con las calificaciones de reseñas.
tags / votes
Códigos de etiquetas públicas, etiquetas y tonos; votos a favor o en contra de esta revisión/comentario específico. Estos no son los votos generales del servicio.
author
ID pública estable, apodo, URL de perfil público y avatar_url. display_name / display_avatar_url reflejan el nombre/logotipo del servicio para obtener una respuesta oficial. Se excluyen el rol de la cuenta, las credenciales, las IP y la actividad privada.
is_official
true solo para una respuesta en nombre del servicio por parte de un propietario de servicio actual. No es una bandera de promoción paga.
company
ID estable, slug/nombre actual, URL de la tarjeta de servicio KYCLESS, logotipo, sitio web principal de clearnet y todos los enlaces de la red pública. Sin credenciales administrativas ni de feeds.
created_at / updated_at
Horas de edición de revisión y publicación original como cadenas UTC ISO 8601. Los cambios de metadatos se rastrean mediante revision / exported_at, no necesariamente updated_at.
order_proof_masked / attachments
Sólo se muestra públicamente la misma referencia de pedido enmascarada. Las referencias completas de los pedidos nunca se exportan. Las reseñas actualmente no tienen archivos adjuntos; attachments es una matriz vacía.
Las definiciones de campo, la capacidad de anulación y los esquemas de respuesta están disponibles en API abierta. Los valores vacíos permanecen nulos o matrices vacías. Los ID y las revisiones son cadenas; las marcas de tiempo usan UTC. Actualmente, los títulos de reseñas independientes y los archivos adjuntos no forman parte del producto.
RSS alimentación
RSS 2.0 proporciona las últimas 20 reseñas visibles de forma predeterminada (hasta 100). Cada elemento contiene un GUID estable, un enlace permanente original, un encabezado generado, una fecha de publicación, una descripción HTML segura, contenido formateado y el nombre para mostrar del autor a través de dc:creator.
content:encoded incluye el texto completo formateado y enlaces al autor, el servicio y la reseña original. El espacio de nombres kycless: proporciona ID, revisión, tipo, origen, ID principal/raíz, clasificación, enlaces de servicio y autor, estado oficial, hora de actualización y la URL detallada JSON. Los códigos de etiquetas públicas se incluyen como RSS categorías.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100RSS es un feed de publicaciones recientes, no el canal completo de archivo o eliminación. Los GUID se mantienen estables tras las ediciones y las fechas de publicación conservan su significado original. Utilice el cursor API para actualizar de manera confiable los registros antiguos y eliminar los eliminados.
Almacenamiento en caché, errores y límites de uso
API y el feed comparten un límite de 120 solicitudes/minuto por IP, incluidas las solicitudes HEAD y condicionales. También se aplican los límites de ráfagas existentes en todo el sitio: envíe solicitudes de forma secuencial, evite ráfagas y realice encuestas cada 1 a 5 minutos. En 429 o 503 obedece Retry-After. OPCIONES y el documento OpenAPI no consumen la cuota específica de exportación.
Las respuestas apoyan ETag. Envíe If-None-Match con la última respuesta ETag para recibir un HTTP 304 sin cuerpo cuando no haya cambios. RSS también admite Última modificación / Si se modificó desde; Prefiera ETag para una detección precisa de cambios. CORS permite lecturas del navegador público sin credenciales. Los métodos de escritura no admitidos devuelven 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 versión 1 mantiene estables los significados de los campos existentes. Se pueden agregar campos opcionales adicionales; ignore los campos que no reconoce. Los cambios importantes requieren una nueva versión API. Mantenga la URL del punto final y el estado del cursor en su configuración de integración.
Cliente Python listo para ejecutar
El cliente de biblioteca estándar mantiene un espejo SQLite dedicado, maneja la paginación del cursor, insertos, eliminaciones, retrasos en los reintentos y un reinicio 409. Confirma los datos locales y el cursor de forma atómica; las ejecuciones fallidas se revierten. No se necesitan paquetes Python externos ni la clave API.
Descargar 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 --fullEjecútelo cada 1 a 5 minutos. Cada archivo SQLite pertenece a un alcance de filtro; cambiar el filtro o usar --full reconstruye ese espejo dedicado. Adapte la misma lógica de inserción/eliminación al almacenar datos en su propia aplicación.
OpenAPI, referencias y contacto
Especificación de OpenAPI 3.1 JSON documenta todos los puntos finales y variantes de respuesta para los clientes generados y la validación.
Referencias de formato: RSS especificación 2.0, HTTP semántica.
Para preguntas de integración o una cuota de solicitudes más alta, utilice los canales de contacto KYCLESS.