AGENT DATA / API V1
先检索，再取证。
公开只读 API，无需登录或密钥。列表只返回轻量条目，图片使用独立 URL；完整规格和曲线按需读取，不必让 Agent 一次解读全部数据库。
供应商面料目录 / 分页与属性检索
浏览面料目录 ↗ · Agent 参数说明 ↗ · 结构枚举与覆盖 ↗ · 数据库实存统计 ↗ · 来源与收录数量 ↗
多平台共用 D1 商品/属性结构。省略 source 为跨平台查询，或传 source=dayao / b2l / yiwugo / onetextiles / qfc 单独查询。onetextiles 为联合纺织网，收录范围与核对状态见 sources；公开目录快照不代表实时库存。qfc 尚未导入，返回零条，不代表平台无商品。布联网、义乌购目前为部分历史商品，不是全站镜像。所有身份保留来源命名空间，不凭名称合并疑似同款。offers 的 minimum/maximum 是该档数量上下限，报价保留原始米、码或千克单位，不用批量最低价冒充少量采购价。
GET /api/v1/catalog?scope=all&source=onetextiles&priced_only=true&price_unit=码&limit=24 GET /api/v1/catalog?scope=all&source=b2l&priced_only=true&price_unit=米&limit=24 GET /api/v1/catalog/facets?source=yiwugo GET /api/v1/catalog/sources GET /api/v1/catalog/schema GET /api/v1/catalog?moq=0.5&q=纯棉&limit=24 GET /api/v1/catalog?scope=all&category=面料&limit=24 GET /api/v1/catalog?scope=all&category=面料&max_moq=2&fiber=cotton&limit=24 GET /api/v1/catalog?scope=all&product_type=府绸&limit=24 GET /api/v1/catalog?scope=all&source_status=unreturned&limit=24 GET /api/v1/catalog?scope=all&source_status=not_seen&limit=24 GET /api/v1/catalog/coverage GET /api/v1/catalog?scope=all&construction=knit&source_only=true&limit=24 GET /api/v1/catalog?scope=all&fiber=cotton&min_gsm=100&max_gsm=250&profile_level=detail GET /api/v1/catalog?has_image=true&limit=24 GET /api/v1/catalog?has_details=true&limit=24 GET /api/v1/catalog?scope=all&has_details=false&limit=24 # has_details / has_image: true 或 false，不接受其他值；分页保留筛选。 # has_details 是旧关联档案，包括同规格参考；profile_level=detail 才是本 SKU 商品详情。 # has_image 只代表已有来源图片，不保证色号一致，更不是物性验证。 # /stats 的 actualLinked / actualPictured 是全目录覆盖数，并非当前筛选结果数。 GET /api/v1/catalog/dayao-sku%3A100091413 GET /api/v1/catalog/dayao-sku%3A100091413/profile
这是轻量目录接口，与原有研究档案接口并行。scope=eligible 默认仅取成品面料、米单位、来源现货标识、正数起订量不超过2米的条目；scope=all 解除这项采购条件，研究整个已入库目录。moq=all|0.5|1 按明确米数筛选，不把公斤或样品起订量当作米数。完整商品详情中的新单位、起订量和销售形式优先于历史目录值；新值缺失时保持未知，不继承旧低起订标记。
q 最长100字符、至多6个空格分隔词，各词同时匹配名称、货号、来源标签或已入库公开属性；% 与 _ 按字面搜索。文字里出现“针织”与来源结构分类是两回事。按结构检索请用 construction=knit，按有标注比例的成分检索用 fiber=cotton，不会把“仿棉”当作确定棉成分。
| 来源属性条件 | 含义 |
|---|---|
| construction | woven / knit / composite / nonwoven / unknown / not_fabric；梭织、针织、复合、非织造、结构待确认、非面料 |
| weave | plain / twill / satin / mixed；平纹、斜纹、缎纹、复合组织 |
| fiber | schema 中的材质ID；只使用能解析的商家成分比例，不以名称补造 |
| source_only=true | 织造结构仅限来源明确工艺或组织字段；排除仅依据品名的推断，不表示本站实测 |
| profile_level | listing：公开列表资料；detail：已核对本SKU的商品详情。两者不能当作同一采集完成度 |
| min_gsm / max_gsm | 0–10000 g/m²，包含边界，最小值不得大于最大值；未知或区间值不冒充单值 |
limit默认24、范围1–100；offset默认0、最大1,000,000，沿相对路径 next 或 HTTP Link 翻页。未知、重复或无效参数返回400。每页返回 datasetRevision 与 profileRevision；任一版本变化时从第一页重新检索。单次响应的总数、行数据和属性摘要绑定同一详情版本，避免激活更新时混用新旧数据。
列表的 profile 只含轻量结构依据、成分、克重、幅宽、颜色、报价/单位/起订量及缺失项，不内嵌全部属性或图片。按 links.profileApi 读取完整公开资料，或按 links.profile 在网页研究；sourceFields[] 保留来源字段名、公开值、单位、origin=listing|detail；原始JSON选项提取人类可读值，并标为sourceFormat=json_options，无法解析的选项保留unresolved=true，不把内部字段定义ID作为布料属性。完整原始响应保留在私有证据档案。详情另含公开商品描述、采购联系方式、销售条件、质检与规格选项，都是商家标注，非本站实测。composition[].name是规范纤维类别，label/sourceLabel保留“再生涤纶”“精梳棉”等来源表达；仅解析完整且加总约100%的明确比例，不能从材质词补百分比或证明环保认证。未采集的商品详情返回404 PROFILE_NOT_COLLECTED，未知数值为null。
detailLevel 与 has_details 继续保留旧关联档案含义，不能代替 profile.level；旧 links.fullRecord / links.purchase 仍可使用。每行保留商品/SKU身份、listedCheckedAt、moqCheckedAt与evidenceSource；完整详情的新采购依据标为 current_selected_sku_detail。库存与散剪服务均未独立验证。统计接口返回目录实存数及已激活详情版本摘要，不代表来源当前实时库存。
1 / 完整档案检索与分页
GET /api/v1/fabrics?fiber=polyester&construction=knit&composition_only=true&min_gsm=100&max_gsm=250&limit=24
响应包含 total / count / limit / offset / next / datasetRevision。跟随相对路径 next 读取下一页，直到为 null。同步也返回 HTTP Link。数据变更后应从第一页重新同步，避免混用不同版本。
| 参数 | 格式与含义 |
|---|---|
| q | 中文 / 英文关键词组合；最长 100 字符，全部词同时匹配 |
| fiber / construction / type | 从 taxonomy 获取 ID；分别表示纤维材质、来源组织结构、常见品类 |
| composition_only | true：材质只能匹配来源成分；默认 false，可匹配名称描述 |
| min_gsm / max_gsm | 克重范围，单位 g/m²；有范围时排除未知值，边界包含 |
| evidence | measured / measured_scalar / visual_asset / supplier_reported |
| source | 来源完整名称，与响应 source 一致 |
| layer | research（默认）或 production（仅已验证生产） |
| sort | id（默认）、name、gsm、thickness；缺失数值排在最后 |
| limit / offset | limit 默认 24，范围 1–100；offset 默认 0 |
采购候选与中国供应商
GET /api/v1/fabrics?layer=candidates&supplier_country=CN&priced_only=true&price_unit=m&limit=10
supplier_country=CN 筛选中国供应商；purchase_mode=online_listing 表示原页有在线购买入口，contact_supplier 表示需联系商家；price_unit=m|kg|yd 仅匹配具有该单位的公开有效报价；priced_only=true 仅显示有价格且单位明确的记录。未知或重复参数返回400。
purchase.offers[] 保留原规格 label、price、currency、unit、unitEvidence、minimum 和 isSample。不同规格可能按米、公斤或码报价，不跨单位合并最低价；原文“米/元”这类倒置标签保留为未知单位，不能自动当作元/米。币种不换算；0元规格不视为免费面料。商家遮挡的报价不采集。旧来源的 tierPrices 仍兼容。
priceFrom 仅在同一明确单位时有值；混合单位、单位不明确时为null。countryCode 是供应商地区，不代表国内交付已验证。在线入口未测试支付、现货或物流；layer=production 仍仅返回已验证生产材料。所有价格是采集时目录条件，不是最终含税到岸价。
图片和详情链接为相对路径，Agent 应结合本站 origin 解析；JSON导出不包含全部原图文件。
领布来源 / 加工阶段与商家质检
fabric_stage=greige|semifinished|finished|unknown 分别表示坯布、半制品、成品布和未知；取自来源分类，不从外观推断。坯布不能直接当作裁衣成品布；成品分类也不等于本站确认适合你的生产用途。taxonomy 的 fabricStages 提供枚举与覆盖量。
同供应商、加工阶段与全部公开基础规格一致的色号保守合并为一组档案，variantCount 表示对应货号数，而不是新增面料种类。完整详情 variants[] 保留各货号的颜色、报价、来源和质检结果；widthCmRange 保留幅宽区间，不取平均冒充实测值。
qualityTests[] 为商家公布的质检，包含 item、parameter、resultText、value、unit、standard、sourceSku；4-5 等等级保留原文，value 为null。缩水率保留正负号和方向。结果仅对应原始货号，不能自动推广到其他色样。cnasClaim 仅为商家声明，未独立核验报告或证书。此类记录仍为 supplier_reported，不升级为本站实测或仿真曲线。列表只带 qualityTestCount，详情按需取得检测数据。
布联网 / 公开档案与采集边界
分页读取本站整理的布联网商品 ↗ · 查看采集覆盖与更新时间 ↗
GET /api/v1/fabrics?layer=candidates&source=布联网&limit=24 GET /api/v1/sources?source=布联网
这是 WeaveMe 自己的只读接口，不是布联网官方 API。核查时未找到正式对外的 API 文档或申请入口，不能据此断言对方没有合作接口。原站 robots 限制分页查询，sitemap 返回首页而非 XML 索引；本站仅整理允许访问的公开目录及实际链接，不枚举商品 ID、不绕过分页限制、登录、验证码或模糊报价。
来源的 coverage 包含 discoveredProducts、importedProducts、pendingProducts、blockedDiscoveryUrls、failedRequests、checkedAt、publicPricingCount；completeSite=false 表示不是全站快照。HTTP 502、超时和无商品身份页面保留为失败，不编造记录。
详情 specifications 提供 yarnCount、density、elasticity、patternStyle、finish、salesUnit、sourceListedAt。原始字段在 rawMetadata.fields 中；compositionNormalization 区分显式百分比、加总100的商家比例与未解析文本。常见缩写统一为中文材质，无法解析或比例矛盾的成分为null，不以名称猜测补全。
公开首页和商品列表中的价格按商品 ID 关联，offers[].kind=catalog_reference；sourceUrl / checkedAt 保留来源和采集时间，原始报价证据在 rawMetadata.publicPriceObservations。详情表模糊不影响另行记录公开目录报价；未取得公开报价才留空。上架时间不等于近期在售或库存确认，采购前需确认规格、数量、税费和交付。
公开采购联系人
完整档案的 supplier.contacts[] 提供 name、role、ownerType、channels、sourceUrl、sourceField、checkedAt 和 visibility。ownerType=supplier 表示商家业务或技术联系人，platform 表示平台客服，不混作厂家直联。channels[].type 为 phone / email / wechat，value 为明确公开的完整值；不会补全截断或掩码号码，也不从手机号推断微信。
links.purchase 指向本站采购资料页，汇总货号、参考价、公开联系方式、原始商品链接与备用检索。原站故障时仍可复制货号和询价摘要。接口只提供公开业务资料，不发送消息、不拨号、不执行购买。供应商条目以“资料来源”展示，研究数据原有许可信息另行保留。
2 / 完整档案与实验曲线
GET /api/v1/fabrics/yarn2022%3AA1 GET /api/v1/fabrics/yarn2022%3AA1/curves?type=stretch&direction=warp&phase=loading GET /api/v1/fabrics/yarn2022%3AA1?include=curves
条目 ID 必须进行 URL 编码。默认详情包含图片 URL、规格、测量、原始字段和出处，不携带曲线点；只有显式请求曲线才传输完整点数据。曲线 type：stretch / poisson / pearloop；direction：warp / weft / bias；phase：loading / unloading（只适用于保留阶段标签的试验）。数值含义以各曲线 xLabel / yLabel、method 和来源证据为准。
空值不是零。只有外观不能推断成分、克重和力学；source_composition 表示来源给出了成分，不代表本站检测。不同测量方法、方向、单位或条件的曲线不可直接混合用于仿真。
以图找布 / Studio 与 Agent
打开 AI 以图找布 Studio ↗ · 读取特征枚举与实际覆盖 ↗
Agent 已有视觉能力时，直接提交结构化特征，无需重复识图。推荐按记录类型区分完整供应商档案与来源目录候选；目录缺失的成分、克重、报价和物性不补造。相关度是可解释检索分数，不是实物相似度概率。
POST /api/v1/studio/recommendations
Content-Type: application/json
{"features":{"colors":["navy"],"surfaces":["twill"],"garments":["tailored"]},
"preferences":{"chinaOnly":true,"smallOrder":true,"includeUnknownMoq":false,"budget":60,"limit":8}}检索版本 retrievalVersion=3：recommendations 只包含关键外观条件有来源文字支持的记录；needsVerification 是部分吻合但有缺项或风险的候选，不计入 count。evidenceCoverage 分别列 required / matched / missing / risks，reasons 保留字段名及来源文本片段。明确颜色、花型、材质类别冲突的记录不进入任何候选层。没有外观条件时，alternatives 才表示纯采购条件备选。limit 分别限制两个外观结果层，均不超过12条。不混算不同货币、公斤、米或码价格，不承诺同款、库存或剪米交付。
GET /api/v1/studio/schema
POST /api/v1/studio/analyze
{"imageDataUrl":"data:image/jpeg;base64,...","consent":true,"requestId":"客户端生成的 UUID","targetGarment":"auto","analysisMode":"components"}
GET /api/v1/studio/jobs/{返回的64位任务ID}
POST /api/v1/studio/recommendations
{"jobId":"已完成任务ID","preferences":{"chinaOnly":true,"smallOrder":true}}targetGarment 可选 auto / top / trousers / dress / outerwear；默认自动选择主要服装。明确指定目标会隔离缓存；改变目标本身不提交识图。结果的 features.recognition 提供 kind / category / styles / colors / tones / patterns，缺失项目保持未知；analysisVersion=4 同时支持分号、换行及 JSON 描述。旧缓存按新解析器读取，不重复计费。usableForRecommendation=false 或目标不一致时，使用该 jobId 推荐返回422 ANALYSIS_NEEDS_CONFIRMATION，不返回无关采购备选。
识图试用限制全站每日20次、每客户端每分钟2次；限额数据库不可用时停止提交。同图同目标的已完成识图24小时缓存；失败不会自动重新提交。选择图片只在本机预览，点击识别后才开始分析。
先按花型、纹理优先召回，再做冲突过滤与证据分层；价格和起订便利只在外观证据相近时影响排序。平纹组织不等于纯色，普通印花不等于花卉。克重只作为造型核样风险，不作为实测垂坠结论。candidateCoverage 的 catalogMatches / catalogEvaluated / catalogTruncated 表明目录命中数、本次评估数与是否截断；每次最多200条，不保证已经检查全库。默认中国低起订目录，smallOrder=false 可查看其他有图面料目录；已激活的逐条商品详情以 source_profile 返回，来源列表以 procurement_index 返回；record.profileLevel 区分 listing / detail。加工阶段、成分、克重、颜色、单位与起订量使用当前来源字段，缺失保持未知。预算为人民币米价时，未知报价的目录不混入。无合适外观证据时 recommendations 可为空，但 needsVerification 仍可给出缺项清楚的待核对候选。visualComparisonPerformed=false 表示没有逐图视觉复核或图片向量检索。
目录 searchKeywords 来自名称、货号、类目和商家标签；多词同时匹配。成分、克重与采购条件只使用来源实际值；sourceDetailsEvaluated 是本次实际进入候选池的逐条详情数，不是全库覆盖数。图片按精确 SKU/商品ID匹配并按需缓存，商家共用图不保证颜色。原站遍历不是原子快照，visualIndex.nonTransactional=true。
分部位面料候选
Studio 使用 analysisMode=components；旧 Agent 不传时仍为 legacy。分部位分析与旧描述使用独立缓存，首次补充分析需要显式提交一次；失败不自动重试或切换旧识图服务。schema 的 materialCatalog 提供12类候选枚举。
features.components[] 区分 main_body / sleeves / skirt_layers / trim / bow / lining / other。只有 materialCandidates[] 中 part=main_body 的候选参与主体召回和小幅优先排序，其他部位不会混入。每个候选包含 category、label、reason、limitations、certainty=hypothesis；不是确定成分、实测克重或物性。候选不会推翻已知颜色、花型、纹理冲突，亦不会写入供应商 composition。
materialAnalysis.status 为 analyzed / description_only / not_analyzed；网页手动修正时标为 manual。旧描述里的“蕾丝饰边”被拆为 trim，光泽不会自动证明缎面组织，未分析的主体类别保持未知。Agent 可以提交 features.materialCandidates=[{"category":"poplin","part":"main_body"}] 作为候选方向；类别不明、非主体或超过3类会被拒绝。候选类别单独检索时只进入待核对层，不冒充已完整匹配。
目录采集状态与历史报价
目录行和完整属性响应含 sourceAvailability，旧目录尚无逐条结果时为 null，不应解释为已下架或现货确认。procurementEvidenceUsable=false 表示不能用于当前采购推荐：来源未返回该 SKU、请求失败、原目录身份未在本次列表出现，或证据校验未通过。delistingConfirmed=false 表示没有确认下架。
这些条目在 scope=all 中保留供研究，但不进入 eligible、明确米数起订筛选或 Studio 的任何推荐层；旧档案也不能绕回候选。当前报价与起订量为 null；historicalQuote 可保留公开旧报价，附原单位、采集时间及 usableForProcurement=false。完整属性接口保留历史原值与相同状态标签，Agent 必须先检查状态，再解释采购字段。
新索引与属性版本分批激活时，只有精确 SKU/商品身份且原始证据哈希相同的属性才参与过滤与推荐。未就绪的属性保持空，不把上一批价格、起订量或成分当成新资料；分类覆盖也按当前索引关联统计。旧版没有证据哈希的目录继续兼容，但不升级其证据等级。
统计中的 sourceStatusCounts / pending / sourceComplete / qualificationStatus 如有提供，应联合读取。补采未完成时，已知符合起订条件的数量只是现有证据下限，不能替代此前核对数或推算全站比例。状态与属性修订随 datasetRevision / profileRevision 更新。
按采集结果核查目录
source_status 可选 all / detail / listing / unreturned / not_seen / failed / legacy / invalid，默认 all（不额外限制）。分别表示全部、已采详情、仅有列表、来源未返回规格、本轮列表未出现、采集失败、未记录本次状态、状态证据异常。这不是库存筛选，404/未返回规格不能解释成已确认下架；legacy 对应 sourceAvailability=null，不假设已经重新核查。
核查未返回或失败记录时请用 scope=all，不要再加尚未确认的 moq；scope=eligible 仍严格执行采购条件，两个条件交集可能为0。网页选择研究状态会切换全部商品并解除明确米数限制，其他名称/材质条件保留。/api/v1/catalog/facets 的 sourceStates[] 给出固定枚举、标签、全目录实际数量及 procurementEvidenceUsable（legacy为null）；数量之和等于当前目录行数，不是独立面料种类数。
研究档案与当前目录分开读取
研究接口 /api/v1/fabrics、单条及旧 /api/fabrics 中的供应商档案保留 purchaseEvidence.kind=archived_supplier_snapshot：observedAt 是档案采集时间，liveSupplierQuery=false、quoteFreshness=as_recorded_not_live、stockStatus=not_rechecked_live。报价和公开联系方式照常提供，但不能解释为本次实时查询或库存/交付确认；具体报价的 checkedAt 如有提供，应另外读取。
领布档案中身份完整时，purchaseEvidence.catalogReference 提供首个归档规格的 platformSkuId、commodityId 和目录查询链接，scope=archive_primary_variant_only，不表示整个色号家族都相同。Agent 可按 links.item 读取轻量目录项，先核对两个身份及 sourceAvailability，再按目录 links.profileApi 取相同原始证据的公开属性。不要把档案其他色号或不同单位的报价套到这个规格；其他来源没有对应目录时该引用为null。旧 offers、联系方式、曲线、笔记及链接均保留，不用新数据静默改写历史档案。
完整分类与起订上限
/api/v1/catalog/facets 仅接受可选 source，返回全库或指定平台的选项和数量：categories、construction、fibers、weave、productTypes、minimumOrders、minimumOrderGroups、moqLimits。countScope=global_catalog_not_current_filters 或 selected_source_not_other_filters，均未叠加当前其他筛选。混纺按含有的每类纤维分别计数，成分数不能相加当商品总数；竹纤维使用 bamboo，unknown 表示未有可解析的商家比例。
max_moq 是正数、最高1,000,000的米单位起订上限，含边界、排除未知及其他单位，不限制现货或类别。请用 scope=all 并独立组合 category；旧 scope=eligible 仍有历史现货面料条件，旧 moq=0.5|1 仍是精确值。max_moq 与精确 moq 同时传入返回400。moqLimits 由实际正数米单位记录生成，不合成不存在的档位；minimumOrderGroups 按 category/unit/minimum/count 给出分布。新访客默认面料且≤1米；按公斤、码或起订未知的商品需取消米数限制查看，网页会明确提示，不静默放宽条件。
product_type 精确匹配来源最后一条「品名」属性，最长200字符；并非每个平台都有此字段，其他原始字段仍可使用 q 检索。来源明确成分、组织、克重与推断证据分别保留。
多采购方案与版本
profile.offers[] 保存剪版/样品及大货方案的 label、price、currency、unit、minimum、isSample、sourceUrl、observedAt。混合单位或无统一报价的商品，profile.price 可以为 null，不代表所有方案均无报价。priced_only=true 和 price_unit 同时查询这些方案；未知单位不当成米价，未知方案起订量不从商品页总体值补造。
分页客户端同时核对 datasetRevision、profileRevision 和 supplierRevisions。任一来源版本变化后从 offset=0 重新查询。不同平台的来源字段、商家、报价时间和身份均保留，未完成同款验证前不自动跨平台去重。
商品图库
目录列表的 profile.imageCount 是当前已保存、去重并符合来源域名规则的商品图片地址数量，不等于图片已下载或当前色号已逐图核对。列表只展示一个封面，带数量角标；按 links.profileApi 读取的 gallery 包含 count、scope、images[].index/url 及说明，图片通过 /api/catalog-media/{sku}/profile/{index} 按需读取并复用 R2 缓存，不需要把所有图片塞入分页结果。
图库仅绑定已激活、SKU与商品身份一致且原始证据哈希相同的属性记录；不接受外部 URL 参数，不自动扫描供应商网页。来源未提供、非法地址、超出图库范围返回404，源图暂时不可用可能返回502/503。原 profile.images 仍保留已采集来源地址，兼容原使用方式。scope=supplier_product_not_selected_color_verification 表示供应商商品级图库，可能有其他颜色、尺寸表或介绍图，不能当作当前规格颜色已确认。详情页支持缩略图切换、大图与键盘操作；新增图片需要后续同步来源属性，打开页面不会实时重抓整条商品资料。
字段覆盖与缺失项
读取全目录资料覆盖 ↗ 是轻量聚合接口，不下载全库JSON；不接受任何查询参数，传 q/scope/limit 等返回400，避免把全库覆盖误认成当前搜索结果。index统计全部SKU身份及属性/图片入口覆盖；fabric仅统计来源类别为面料的条目，排除纱线、坯布等类别。不同色号分别计数，不等于独立面料种类。
fields中的known / missing / denominator / percent表示字段有记录的数量和比例，空分母时percent=null，不是匹配准确率。克重和幅宽分别统计单值与区间；结构拆分sourceField / nameBased / otherEvidence，不把品名推断当成来源组织标注。sourceColorDescription只统计独立来源颜色字段，可能仅写“色织/多色”；不计标题颜色词，也不等于色号明确或照片一致。
quotedPriceWithUnit只统计现有采购证据可用、正数且单位明确的报价，按byUnit分别计数；元/个可能是样品或其他销售形式，不当作米价。reportedMoqWithUnit不等于已确认散剪。所有字段保留商家标注的性质，不升级为本站实测、库存或交付确认。版本绑定datasetRevision/profileRevision，sourceComplete=false时不能推算来源全站覆盖或最终低起订比例。
3 / Agent 最小读取示例
import requests
base = "https://weaveme.studio"
page = requests.get(base + "/api/v1/fabrics", params={
"fiber": "polyester", "composition_only": "true", "limit": 10
}, timeout=30)
page.raise_for_status()
data = page.json()
for fabric in data["records"]:
detail = requests.get(base + fabric["links"]["self"], timeout=30)
detail.raise_for_status()
# Load the fabric image separately when vision is needed.
# Follow data["next"] for more results; compare datasetRevision.
允许跨域 GET / HEAD / OPTIONS。非法或重复参数返回 400，未知条目 404，写入方法 405。API 是公开研究读取接口，请缓存结果并控制请求频率。没有提供账户、写入和库存确认能力。
旧 /api/fabrics 保留兼容，仍列出全库摘要；新集成建议使用分页 v1。笔记仍只保存在当前浏览器，不在公开 API 中。
统一小量购买标识
smallQuantityStatus 与 smallQuantityPurchase.status 的值为 yes / no / unknown，显示“是 / 否 / 不确定”。有明确的 ≤2米、≤2码或≤2公斤起订依据为 yes；已记录方案均明确超过门槛为 no；缺少数量、支持的单位或来源依据为 unknown。商品起订与具体方案分别保留，剪版/样品方案会标明，不继承商品起订量来补造方案数量。
GET /api/v1/catalog?scope=all&small_quantity=yes&source=onetextiles&limit=5 GET /api/v1/catalog?scope=all&small_quantity=unknown&source=yiwugo&limit=5
这是版本化业务规则 small-quantity-v1 的派生字段，不覆盖来源原始数量、价格或单位。公斤不能直接换成米；标识不代表库存已核实或一定够缝一件衣服。旧 max_moq 和 moq 参数仍只处理米单位，保持旧接口含义。
以图找布对已激活的来源目录联合检索，返回 candidateCoverage.catalogSources 说明参与平台。结果为有界优先召回，不代表逐图比对全部商品；已知颜色/结构冲突仍被排除。米价预算只比较米价，不将公斤或码报价直接当米价。
多币种与来源字段差异
雅其信 source=yaqixin 与现有平台共用目录结构，查询已导入的公开商品详情快照；收录范围以 sources 接口为准。profile.currency、offers[].currency 保留原币种，USD 不当作人民币，不自动换汇；priceMaximum 是来源区间报价的上界，不是数量上限，不能推断成数量阶梯。
sourceConflicts 保留同一来源不同区域的字段差异及原文出处。起订量冲突时小量购买为“不确定”，不会继承网页头部默认数量；结构冲突时保持待确认。所有公开原字段仍在 sourceFields，section 标明头部、属性表或描述。以图找布默认不纳入未确认小量条件；人民币米价预算不比较美元报价。
GET /api/v1/catalog?scope=all&source=yaqixin&priced_only=true&limit=5 GET /api/v1/catalog?scope=all&source=yaqixin&small_quantity=unknown&limit=5
图片用途与供应商起价
source=maoxing 收录茂兴织染公开首页明确列出的13款商品，不代表全部库存或色号。gallery.images[].kind 区分 supplier_application_reference（产品应用参考图，非面料实拍）与 supplier_color_card（供应商电子色卡）；label 提供中文用途说明。不能把应用示意图用作布面颜色、纹理已匹配的证据。
offers[].kind=source_starting_price 表示供应商起价，不是固定成交价；保留币种、原单位与该方案起订量。此来源公开大货150公斤起订，不因存在寄样服务而标为支持小量购买。只写“克”而没有面积单位的克重保留在来源字段，不填入 gsm；公斤、米数和克重不互相倒算补缺。
GET /api/v1/catalog?scope=all&source=maoxing&priced_only=true&limit=5 GET /api/v1/catalog/maoxing%3A6603/profile
进口面料与待确认单位
source=fdf 为中国进口面料商 FDF 的公开商品档案，供应商所在地不代表面料生产国家。commercial.productionCountryRaw 保留商品标注的生产国家，未标注时留空。
offers[].kind=source_public_quote_unit_unconfirmed 保留来源公开人民币原价，但计价单位、最低购买量及裁剪增量尚待确认，因此 unit 和 minimum 可为 null。不把价格统一乘十或换算成每米价；这类报价不满足 priced_only=true 的明确单位要求，小量购买标为不确定。裸克重/门幅保留在 sourceFields，没有明确单位时不填入 gsm 或 widthCm。库存与配送未经独立核实。
GET /api/v1/catalog?scope=all&source=fdf&limit=5 GET /api/v1/catalog/fdf%3A2577601/profile
Fabric House：数量门槛与整单金额
source=fabrichouse 目前仅收录已观察的两页棉类目录200条商品，并非全站。价格为欧元每米、未含增值税，offers 各档数量分别保留，不自动换汇。商品1米起订不代表只买1米即可结账；commercial.basketMinimum 保留来源整单最低150 EUR要求，分页摘要也提供 profile.basketMinimum。
小量购买标识只判断商品数量门槛，不能替代整单金额和跨境配送条件。中国配送未验证，Studio默认中国供应商条件会排除此来源；人民币预算不会与EUR报价混比。linearWeightGm 是每延米重量g/m，不是 gsm。可见幅宽和结构化元数据有单位差异时保留原值与警告。
GET /api/v1/catalog?scope=all&source=fabrichouse&priced_only=true&limit=5 GET /api/v1/catalog/fabrichouse%3AF000052902/profile