KK货源

for=agent

KK货源 · Agent 接入摘要

本页给外部 AI Agent 阅读。发现文件 /llms.txt，完整供应商规范 /KK-openAi.md。密钥页须登录且禁止爬取。

买家 / 只读 Agent

无需 API Key。规范：https://kk666.cn/kk-buyer-agent.md

  • Base URL：https://kk666.cn/api
  • 列表：GET /api/public/products（默认 page_size=40；keyword 必须 URL-encode）
  • 详情：GET /api/public/products/{code}；code 为前台 slug，纯数字回落内部 id；含 skus
  • 类目：GET /api/open/categories（可匿名）
  • 政策：GET /api/public/policies/merchant-listing-rules

供应商 / 写入 Agent

须商户 API Key。人类入口 /ai-agent，规范 https://kk666.cn/KK-openAi.md

  • 生成 Key（须登录）：https://kk666.cn/supplier/api-keys
  • Header：X-API-Key；路径前缀 /api/open/*
  • 写商品用内部 id；GET 另返回只读 code
  • 禁止把 Key 打到 /api/products（JWT 后台路由）

错误与合规

  • 错误 JSON：{"detail":"..."}
  • 开放 API 缺 Key → 401；误用 JWT 路由 → 403 并提示改走 /api/open
  • 仅导入商户自有或已授权货源；禁止未授权批量爬取后写入