Быстрый старт
Используйте JSON API для полного зеркала. Используйте RSS для отображения последних публикаций. Оба генерируются из одного и того же общедоступного набора данных. Все запросы доступны только для чтения.
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'Присвойте записи KYCLESS, сохраните автора и создайте обратную ссылку на url. Импортированные обзоры должны отличаться от обзоров, размещенных непосредственно на вашей платформе.
Конечные точки и фильтры
GET /api/v1/reviews— архив и изменения в порядке возрастания редакций экспорта. По умолчанию включены как отзывы, так и ответы.GET /api/v1/reviews/123— одна запись. Известные удаленные записи возвращают HTTP 410 с минимальным надгробием; неизвестные идентификаторы возвращают 404.GET /feeds/reviews.xml— последние видимые публикации по исходной дате создания, сначала самые новые. По умолчанию включены обзоры верхнего уровня.GET /api/v1/openapi.json— машиночитаемый контракт OpenAPI 3.1. HEAD и OPTIONS поддерживаются.
| Параметр | Значение |
|---|---|
| cursor | JSON только список. Начните с 0; затем используйте pagination.next_cursor точно так же, как вернулось. Рассматривайте его как непрозрачную десятичную строку. |
| limit | 1–100. JSON по умолчанию 50; RSS по умолчанию 20. |
| type | все, просмотрите или ответьте. JSON все по умолчанию; RSS обзор по умолчанию. |
| company_id | Стабильный идентификатор услуги; рекомендуется для длительной синхронизации. Действительный идентификатор без соответствующих записей возвращает пустой список. |
| service | Текущий служебный номер, например. микстум. Используйте сервис или Company_id. Неизвестные пули возвращают 404. Пули могут меняться; Идентификаторы стабильны. |
Неизвестные, повторяющиеся или недопустимые параметры возвращают значение HTTP 400. При фильтрации используется служба и тип записи; маркеры удаления сохраняют эти внутренние ключи фильтра, но не раскрывают старое содержимое.
Полный архив, обновления и удаления
- Начните с
cursor=0. Обновить опубликованные записи наglobal_id; удалить локальные копии, когдаstatus=deleted. - Следуйте
pagination.next_urlдоhas_more=false. Не угадывайте и не увеличивайте значения курсора. - Сохранять
next_cursorтолько после успешного применения этой страницы. Повторите опрос с сохраненным курсором, обычно каждые 1–5 минут. - Сохраняйте отдельные курсоры для каждого фильтра. Для изменения фильтров необходимо начать с 0 и согласовать соответствующий локальный набор данных.
{
"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.Прогноз проверяет общедоступные данные не чаще одного раза в пять секунд. Он отслеживает отредактированный текст, баллы, теги, авторов, ссылки на сервисы, официальный статус и голоса в комментариях. Множественные изменения между проверками могут объединиться в одно последнее состояние: это синхронизация, а не архив истории изменений.
Удаление, принудительное удаление, отмена публикации службы или исключение импортированного потока заменяет ранее экспортированную запись минимальным захоронением. Старый текст и полезные данные автора/службы удаляются из проекции. delete_at записывает, когда при экспорте наблюдалось удаление. Повторная публикация записи приводит к созданию более поздней опубликованной версии.
{
"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"
}Повторяющиеся записи — это нормально: применяйте состояние только в том случае, если его версия новее вашей локальной версии. Лента может переходить к предыдущим несвязанным версиям, если установлен фильтр. Курсор перед сервером возвращает 409, например, после восстановления: перезапустите с 0 и выполните согласование, удалив локальные записи, отсутствующие в перестроенном наборе данных. Также рекомендуется периодическая полная сверка.
Экспортируются только оригинальные темы KYCLESS. Будущий импорт отмечается отдельно и исключается, чтобы избежать циклического реимпорта. Запись, удаленная до того, как она была экспортирована, не имеет надгробия экспорта. Надгробия для ранее экспортированных записей сохраняются без личного содержания.
Поля общедоступных данных
id / global_id
Стабильные струны. id локальный; global_id (kycless:comment:123) находится в глобальном пространстве имен. Никогда не делайте дедупликацию по автору или тексту обзора.
origin / status / type
origin — это kycless. status — это published или deleted; type — это review (высший уровень, включая обзоры наследия без рейтинга) или reply.
revision / exported_at
Монотонная версия экспорта (десятичная строка) и время в формате UTC, когда это экспортированное состояние изменилось. Изменения метаданных и комментариев-голосований также приводят к новой редакции.
url / parent_id / root_review_id
Исходное окончание постоянной ссылки #comment-ID; прямой родительский элемент (null для корня) и идентификатор корневого потока. Ответы могут оставаться видимыми после удаления их корня.
title / display_title / title_is_generated
KYCLESS в настоящее время не имеет отдельного заголовка обзора: title — это null. display_title — это сгенерированный заголовок канала, явно отмеченный знаком title_is_generated=true.
body.source / source_format
Исходный общедоступный текст со встроенной разметкой KYCLESS; source_format — это kycless-inline-v1. Поддерживает **bold**, *italic*, __underline__, ~~strike~~ и [label](https://example.org).
body.text / body.html
Обычный текст и экранированный, безопасно отображаемый HTML. Используйте body.text для рендеринга текста и body.html для форматированного рендеринга. Разрешенные элементы HTML: strong, em, u, s, a и br. В ссылках используются HTTP(S) и rel=nofollow ugc noopener noreferrer.
rating
Объект {value,min:1,max:5} или null, если звездный рейтинг отсутствует. Не интерпретируйте null как ноль звезд и не смешивайте количество ответов с оценками отзывов.
tags / votes
Коды общедоступных тегов, этикетки и тон; голоса «за» или «против» по данному конкретному обзору/комментарию. Это не общее количество голосов службы.
author
Стабильный общедоступный идентификатор, псевдоним, URL общедоступного профиля и avatar_url. display_name / display_avatar_url обозначают название/логотип службы для официального ответа. Роль учетной записи, учетные данные, IP-адреса и личная активность исключаются.
is_official
true только для ответа от имени службы текущего владельца службы. Это не флаг платной акции.
company
Стабильный идентификатор, текущий пул/имя, URL-адрес сервисной карты KYCLESS, логотип, основной веб-сайт Clearnet и все ссылки в общедоступных сетях. Никаких административных или фидовых учетных данных.
created_at / updated_at
Время редактирования оригинальной публикации и обзора в виде строк ISO 8601 UTC. Изменения метаданных отслеживаются по revision/exported_at, не обязательно updated_at.
order_proof_masked / attachments
Публикуется только та же ссылка на замаскированный заказ. Полные ссылки на заказы никогда не экспортируются. В настоящее время отзывы не имеют вложений; attachments — пустой массив.
Определения полей, возможность обнуления и схемы ответов доступны в OpenAPI. Пустые значения остаются нулевыми или пустыми массивами. Идентификаторы и версии представляют собой строки; временные метки используют UTC. Отдельные заголовки отзывов и вложения файлов в настоящее время не являются частью продукта.
RSS корм
RSS 2.0 по умолчанию предоставляет последние 20 видимых отзывов (до 100). Каждый элемент содержит стабильный GUID, исходную постоянную ссылку, сгенерированный заголовок, дату публикации, безопасное описание HTML, форматированный контент и отображаемое имя автора через dc:creator.
content:encoded включает полный форматированный текст и ссылки на автора, сервис и оригинальный обзор. Пространство имен kycless: предоставляет идентификаторы, версию, тип, происхождение, родительские/корневые идентификаторы, рейтинг, ссылки на службы и авторов, официальный статус, время обновления и подробный URL-адрес JSON. Коды общедоступных тегов включены в категории RSS.
https://kycless.cc/feeds/reviews.xml
https://kycless.cc/feeds/reviews.xml?service=mixtum
https://kycless.cc/feeds/reviews.xml?type=all&limit=100RSS — это лента последних публикаций, а не полный архив или канал удаления. Идентификаторы GUID остаются неизменными при всех изменениях, а даты публикации сохраняют свое первоначальное значение. Используйте курсор API для надежного обновления старых записей и удаления удаленных.
Кэширование, ошибки и ограничения на использование
API и фид имеют общий лимит в 120 запросов в минуту на каждый IP-адрес, включая HEAD и условные запросы. Также применяются существующие ограничения на пакетную обработку на уровне сайта: отправляйте запросы последовательно, избегайте пакетных пакетов и опрашивайте каждые 1–5 минут. На 429 или 503 подчиняйтесь Retry-After. OPTIONS и документ OpenAPI не используют квоту, специфичную для экспорта.
Ответы поддерживают ETag. Отправьте If-None-Match вместе с последним ответом ETag, чтобы получить HTTP 304 без тела, если оно не изменилось. RSS также поддерживает Last-Modified/If-Modified-Since; предпочитайте ETag для точного обнаружения изменений. CORS позволяет осуществлять чтение в общедоступном браузере без учетных данных. Неподдерживаемые методы записи возвращают 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'Версия 1 сохраняет значения существующих полей стабильными. Могут быть добавлены дополнительные необязательные поля; игнорировать поля, которые вы не распознаете. Критические изменения требуют новой версии API. Сохраните URL-адрес конечной точки и состояние курсора в конфигурации интеграции.
Готовый к работе клиент Python
Клиент стандартной библиотеки поддерживает выделенное зеркало SQLite, обрабатывает нумерацию страниц курсора, обновление, удаление, задержку повтора и сброс 409. Он фиксирует локальные данные и курсор атомарно; неудачные прогоны откатываются. Никаких внешних пакетов Python или ключа API не требуется.
Скачать 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 --fullЗапускайте его каждые 1–5 минут. Каждый файл SQLite принадлежит одной области фильтра; изменение фильтра или использование --full перестраивает выделенное зеркало. Адаптируйте ту же логику добавления/удаления при хранении данных в вашем собственном приложении.
OpenAPI, ссылки и контакты
Спецификация OpenAPI 3.1 JSON документирует все конечные точки и варианты ответа для сгенерированных клиентов и проверки.
Ссылки на формат: RSS спецификация 2.0, HTTP семантика.
Для вопросов по интеграции или более высокой квоте запросов используйте контактные каналы KYCLESS.