Saltar al contenido
Desarrolladores

KYCLESS Reseñas API y RSS

Revisiones públicas originales, respuestas y metadatos de servicio. Un archivo completo y actualizaciones confiables, sin scraping. No se requiere cuenta ni clave API.

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ámetroSignificado
cursorJSON solo lista. Comience en 0; luego use pagination.next_cursor exactamente como se devuelve. Trátelo como una cadena decimal opaca.
limit1–100. JSON predeterminado 50; RSS predeterminado 20.
typetodos, revisar o responder. JSON predeterminado todo; RSS revisión predeterminada.
company_idID 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.
serviceSlug 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

  1. Comience con cursor=0. Insertar registros publicados por global_id; elimine las copias locales cuando status=deleted.
  2. Siga pagination.next_url hasta has_more=false. No adivine ni incremente los valores del cursor.
  3. Persista next_cursor solo después de aplicar con éxito esa página. Vuelva a sondear con el cursor guardado, normalmente cada 1 a 5 minutos.
  4. 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=100

RSS 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.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

Ejecú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.