{"openapi":"3.1.0","info":{"title":"超鑫选品开放 API","version":"1.2.0","description":"经过来源脱敏的商品、库存、运费、证书、图片和合作方订单接口"},"servers":[{"url":"https://chaoxinerp.com/api/open/v1","description":"正式环境"},{"url":"https://chaoxinerp.com/api/open/sandbox/v1","description":"测试环境"}],"components":{"securitySchemes":{"CxApiKey":{"type":"apiKey","in":"header","name":"X-CX-API-Key"},"CxSignature":{"type":"apiKey","in":"header","name":"X-CX-Signature"}}},"security":[{"CxApiKey":[],"CxSignature":[]}],"paths":{"/products":{"get":{"summary":"查询脱敏商品与实时库存","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"warehouse","in":"query","schema":{"type":"string"}},{"name":"sku","in":"query","description":"商品列表返回的超鑫渠道 SKU；传入后返回详情","schema":{"type":"string"}}],"responses":{"200":{"description":"不包含上游编号、供应商链接或仓库联系人资料的商品数据"}}}},"/assets":{"get":{"summary":"读取超鑫代理的商品图片","parameters":[{"name":"sku","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"schema":{"type":"string","enum":["main","gallery","description"]}},{"name":"index","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"图片文件"}}}},"/shipping-rates":{"post":{"summary":"按美国邮编、商品和仓库获取实时物流报价","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["country","postal_code","items"],"properties":{"country":{"type":"string","example":"US"},"postal_code":{"type":"string","example":"91761"},"items":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","required":["sku","quantity"],"properties":{"sku":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":999}}}}}}}}},"responses":{"200":{"description":"按仓库分组的可用渠道及美元运费"},"422":{"description":"当前自动报价不支持该目的国家"}}}},"/orders":{"get":{"summary":"查询合作方订单","responses":{"200":{"description":"订单列表或单个订单"}}},"post":{"summary":"创建合作方订单","responses":{"201":{"description":"订单已创建"}}}},"/certificates":{"get":{"summary":"下载超鑫代理的商品证书","parameters":[{"name":"sku","in":"query","required":true,"schema":{"type":"string"}},{"name":"index","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"证书文件"}}}}}}