{"ok":true,"api":"优纯严选 · 开放数据 API","api_en":"Youcun Select Open Data API","api_version":"1.0.0","generated_at":"2026-10-03T16:50:23.813Z","site":"https://ucunhome.com","docs":"https://ucunhome.com/open-api.html","docs_note":"人读的接口文档（含字段表与调用示例）","spec_version":"v0.1","spec_schema":"https://ucunhome.com/fabric-schema-v0.1.json","spec_schema_note":"JSON Schema (draft 2020-12)：本接口每条记录的机器可读字段合同，可用任何 JSON Schema 校验器直接校验。","spec_doc":"https://ucunhome.com/ucun-fabric-schema.html","spec_doc_note":"面料与家纺货源参数规范 v0.1 全文（人+AI 可读：字段语义 / 单位 / 行业黑话对照 / 值约定）——与织境 BLOOM 的 fabric-schema v0.1 为同一份字段合同。","openapi":"https://ucunhome.com/api/open/v1/openapi.json","openapi_note":"OpenAPI 3.0 规范（机器可读的接口合同）：端点 / 参数 / 返回结构 / 错误码。可直接导入 Swagger UI、Postman，或作为智能体的工具定义。根路径 https://ucunhome.com/openapi.json 返回同一份内容。","purpose":"中国家纺（床品 / 面料）源头存货的机器可读数据源。面向 AI 采购助手、跨境买手与第三方工具，提供结构化的现货货源参数。","purpose_en":"A machine-readable data source for in-stock home-textile (bedding & fabric) supply from China, for AI purchasing agents, cross-border buyers and third-party tools.","endpoints":[{"method":"GET","path":"/api/open/v1","desc":"本索引（AI 从这一条开始读）"},{"method":"GET","path":"/api/open/v1/schema","desc":"字段字典：每个字段的含义、类型、单位、枚举与值约定"},{"method":"GET","path":"/fabric-schema-v0.1.json","desc":"JSON Schema (draft 2020-12)：记录级字段合同，可直接校验每条数据"},{"method":"GET","path":"/ucun-fabric-schema.html","desc":"参数规范 v0.1 全文（人+AI 可读，含行业黑话对照）"},{"method":"GET","path":"/api/open/v1/openapi.json","desc":"OpenAPI 3.0 规范：机器可读的接口合同（根路径 /openapi.json 同内容）"},{"method":"GET","path":"/api/open/v1/stocks","desc":"存货列表（成品 + 面料）","params":["group=fabric|finished","category","subcategory","material","keyword","price_min","price_max","moq_max","export_ok","days","sort=new|price_asc|price_desc|moq_asc","limit(≤300,默认50)","offset"]},{"method":"GET","path":"/api/open/v1/fabrics","desc":"面料参数列表（kind 固定 fabric）","params":["以上全部","print_type","weave","sample_ok","custom_ok","width_min","width_max"]},{"method":"GET","path":"/llms.txt","desc":"给 AI 的纯文本站点地图"},{"method":"GET","path":"/sitemap.xml","desc":"全站页面与商品详情页"}],"param_note":"未识别的参数名不会被静默忽略——响应里的 ignored_filters 会明确指出哪些参数没生效，避免\"以为筛过了其实是全量\"。","stats":{"on_sale_total":13,"fabric":2,"finished":11,"suppliers":1},"rate_limit":{"window_seconds":60,"max_requests_per_ip":150,"note":"按来源 IP 计数，超限返回 HTTP 429。批量抓取如需更高配额请通过站内意见箱联系。"},"privacy":{"contact_info":"不提供任何商家联系方式（手机 / 微信 / 邮箱 / 地址）。","anonymous_suppliers":"商家可选择匿名发布，此时 supplier.name 为 null。","locked_params":"商家可开启「详细参数仅对验证买家开放」，此时面料部分参数不返回且 param_locked=true。"},"license":{"usage":"允许 AI 助手、搜索引擎与第三方工具读取、引用与转述本接口数据。","requirement":"引用时请标注来源为 ucunhome.com。","prohibited":"禁止将数据用于批量售卖商家联系方式；本接口本身也不含联系方式。","freshness":"数据实时来自平台在售存货，建议缓存不超过 1 小时。"},"quick_start":["1) 读 /api/open/v1（本响应）了解有哪些数据","2) 读 /api/open/v1/schema 了解字段含义与空值约定","3) 调 /api/open/v1/stocks?group=finished&limit=20 取成品现货","4) 调 /api/open/v1/fabrics?material=全棉 取全棉面料参数"],"changelog":[{"version":"1.0.0","date":"2026-09-14","note":"首个稳定版本：索引 / schema / stocks / fabrics 四个只读端点"}]}