Pular para o conteúdo
Desenvolvedores

KYCLESS Avaliações API e RSS

Avaliações públicas originais, respostas e metadados de serviço. Um arquivo completo e atualizações confiáveis, sem raspar. Nenhuma conta ou chave API é necessária.

Início rápido

Use JSON API para um espelho completo. Use RSS para exibir publicações recentes. Ambos são gerados a partir do mesmo conjunto de dados público. Todas as solicitações são somente leitura.

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'

Atribua registros a KYCLESS, preserve o autor e vincule de volta a url. Mantenha as avaliações importadas distinguíveis das avaliações postadas diretamente em sua plataforma.

Terminais e filtros

  • GET /api/v1/reviews — arquivo e alterações, em ordem crescente de revisão de exportação. O padrão inclui avaliações e respostas.
  • GET /api/v1/reviews/123 — um registro. Registros removidos conhecidos retornam HTTP 410 com uma lápide mínima; IDs desconhecidos retornam 404.
  • GET /feeds/reviews.xml — últimas publicações visíveis por data de criação original, as mais recentes primeiro. O padrão inclui avaliações de nível superior.
  • GET /api/v1/openapi.json — contrato OpenAPI 3.1 legível por máquina. HEAD e OPTIONS são suportados.
ParâmetroSignificado
cursorJSON apenas lista. Comece em 0; então use pagination.next_cursor exatamente como retornado. Trate-o como uma string decimal opaca.
limit1–100. JSON padrão 50; RSS padrão 20.
typetudo, revise ou responda. JSON padrão tudo; RSS revisão padrão.
company_idID de serviço estável; recomendado para sincronização de longa duração. Um ID válido sem registros correspondentes retorna uma lista vazia.
serviceSlug de serviço atual, por ex. mixtum. Use serviço ou company_id. Slugs desconhecidos retornam 404. Slugs podem mudar; Os IDs são estáveis.

Parâmetros desconhecidos, duplicados ou inválidos retornam HTTP 400. A filtragem usa o serviço e o tipo do registro; os marcadores de exclusão retêm essas chaves de filtro internas, mas não expõem nenhum conteúdo antigo.

Arquivo completo, atualizações e exclusões

  1. Comece com cursor=0. Upsert registros publicados por global_id; remova as cópias locais quando status=deleted.
  2. Siga pagination.next_url até has_more=false. Não adivinhe nem aumente os valores do cursor.
  3. Persista next_cursor somente após aplicar essa página com sucesso. Pesquise novamente com o cursor salvo, normalmente a cada 1–5 minutos.
  4. Mantenha cursores separados por filtro. A alteração dos filtros requer começar em 0 e reconciliar o conjunto de dados local correspondente.
{
  "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.

A projeção verifica os dados públicos comprometidos no máximo uma vez a cada cinco segundos. Ele rastreia textos editados, pontuações, tags, autores, links de serviços, status oficial e votos de comentários. Múltiplas edições entre verificações podem se unir em um estado mais recente: isto é sincronização, não um arquivo de histórico de edição.

A exclusão, exclusão irreversível, cancelamento de publicação de serviço ou exclusão de um thread importado substitui um registro exportado anteriormente por uma marca de exclusão mínima. Texto antigo e cargas úteis de autor/serviço são removidas da projeção. Delete_at registra quando a exportação observou remoção. A republicação do registro produz uma revisão 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"
}

Registros repetidos são normais: aplique um estado somente quando sua revisão for mais recente que sua revisão local. O feed pode avançar além de revisões não relacionadas quando um filtro é definido. Um cursor à frente do servidor retorna 409, por exemplo, após uma restauração: reinicie em 0 e reconcilie, removendo entradas locais ausentes do conjunto de dados reconstruído. A reconciliação completa periódica também é recomendada.

Somente threads KYCLESS originais são exportados. As importações futuras são marcadas separadamente e excluídas para evitar reimportações circulares. Um registro removido antes de ser exportado não possui marca de exclusão de exportação. As lápides de registros exportados anteriormente são retidas sem conteúdo pessoal.

Campos de dados públicos

id / global_id

Cordas estáveis. id é local; global_id (kycless:comment:123) tem namespace global. Nunca desduplique por autor ou texto de revisão.

origin / status / type

origin é kycless. status é published ou deleted; type é review (nível superior, incluindo revisões legadas sem classificação) ou reply.

revision / exported_at

Revisão de exportação monotônica (sequência decimal) e hora UTC quando esse estado exportado foi alterado. As alterações nos metadados e na votação dos comentários também produzem uma nova revisão.

url / parent_id / root_review_id

Finalização do link permanente original #comment-ID; pai direto (null para uma raiz) e ID do thread raiz. As respostas podem permanecer visíveis depois que sua raiz for excluída.

title / display_title / title_is_generated

KYCLESS atualmente não tem título de revisão separado: title é null. display_title é um cabeçalho de feed gerado, explicitamente marcado por title_is_generated=true.

body.source / source_format

Texto público original com marcação embutida KYCLESS; source_format é kycless-inline-v1. Suporta **bold**, *italic*, __underline__, ~~strike~~ e [label](https://example.org).

body.text / body.html

Texto simples e HTML com escape e renderizado com segurança. Use body.text para renderização de texto e body.html para renderização formatada. Elementos HTML permitidos: strong, em, u, s, a e br. Os links usam HTTP(S) e rel=nofollow ugc noopener noreferrer.

rating

Objeto {value,min:1,max:5} ou null quando não existe classificação por estrelas. Não interprete null como zero estrelas ou misture contagens de respostas com avaliações de comentários.

tags / votes

Códigos, rótulos e tons de tags públicas; votos positivos/negativos nesta revisão/comentário específico. Estes não são os votos gerais do serviço.

author

ID público estável, apelido, URL de perfil público e avatar_url. display_name / display_avatar_url refletem o nome/logotipo do serviço para uma resposta oficial. A função da conta, credenciais, IPs e atividades privadas estão excluídas.

is_official

true apenas para uma resposta em nome do serviço por um proprietário atual do serviço. Não é uma bandeira de promoção paga.

company

ID estável, slug/nome atual, URL do cartão de serviço KYCLESS, logotipo, site principal da clearnet e todos os links de rede pública. Nenhuma credencial administrativa ou de feed.

created_at / updated_at

Publicação original e tempos de edição de revisão como strings ISO 8601 UTC. As alterações de metadados são rastreadas por revision / exported_at, não necessariamente updated_at.

order_proof_masked / attachments

Apenas a mesma referência de pedido mascarada mostrada publicamente. Referências completas de pedidos nunca são exportadas. As avaliações atualmente não têm anexos; attachments é um array vazio.

Definições de campo, nulidade e esquemas de resposta estão disponíveis em API aberta. Valores vazios permanecem matrizes nulas ou vazias. IDs e revisões são strings; carimbos de data e hora usam UTC. Atualmente, títulos de revisão separados e anexos de arquivo não fazem parte do produto.

RSS alimentação

RSS 2.0 fornece as últimas 20 avaliações visíveis por padrão (até 100). Cada item contém um GUID estável, link permanente original, título gerado, data de publicação, descrição HTML segura, conteúdo formatado e nome de exibição do autor via dc:creator.

content:encoded inclui o texto formatado completo e links para o autor, serviço e revisão original. O namespace kycless: fornece IDs, revisão, tipo, origem, IDs pai/raiz, classificação, links de serviço e autor, status oficial, horário de atualização e o URL detalhado JSON. Os códigos de tags públicos estão incluídos como categorias 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 é um feed de publicações recentes, não o arquivo completo ou canal de exclusão. Os GUIDs permanecem estáveis ​​durante as edições e as datas de publicação mantêm seu significado original. Use o cursor API para atualizar registros antigos de forma confiável e remover os excluídos.

Cache, erros e limites de uso

API e feed compartilham um limite de 120 solicitações/minuto por IP, incluindo solicitações HEAD e condicionais. Os limites de intermitência existentes em todo o site também se aplicam: envie solicitações sequencialmente, evite intermitências e faça pesquisas a cada 1–5 minutos. Em 429 ou 503 obedeça Retry-After. OPTIONS e o documento OpenAPI não consomem a cota específica de exportação.

As respostas suportam ETag. Envie If-None-Match com a última resposta ETag para receber um HTTP 304 sem corpo quando inalterado. RSS também suporta Última Modificação / If-Modified-Since; prefira ETag para detecção precisa de alterações. O CORS permite leituras de navegador público sem credenciais. Métodos de gravação não suportados retornam 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'

A versão 1 mantém estáveis ​​os significados dos campos existentes. Campos opcionais adicionais podem ser adicionados; ignore os campos que você não reconhece. Mudanças importantes requerem uma nova versão API. Mantenha a URL do endpoint e o estado do cursor na configuração de integração.

Cliente Python pronto para executar

O cliente da biblioteca padrão mantém um espelho SQLite dedicado, lida com paginação do cursor, upserts, exclusões, atrasos de repetição e uma redefinição 409. Ele confirma os dados locais e o cursor atomicamente; execuções com falha são revertidas. Nenhum pacote Python externo ou chave API é necessário.

Transferir 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

Execute-o a cada 1–5 minutos. Cada arquivo SQLite pertence a um escopo de filtro; alterando o filtro ou usando --full reconstrói aquele espelho dedicado. Adapte a mesma lógica upsert/delete ao armazenar dados em seu próprio aplicativo.

OpenAPI, referências e contato

Especificação OpenAPI 3.1 JSON documenta todos os terminais e variantes de resposta para clientes gerados e validação.

Referências de formato: RSS Especificação 2.0, HTTP semântica.

Para questões de integração ou uma cota de solicitação maior, use os canais de contato KYCLESS.