2026/2/28 9:51:23
网站建设
项目流程
昆明网站seo多少钱,有没有类似书签的wordpress主题,天元建设集团有限公司第八分公司,家政网站建设一、接入前准备#xff08;必须完成#xff09;
1. 注册与认证#xff08;账号与资质#xff09;
访问 MIC 开放平台#xff1a;https://open.made-in-china.com/用企业账号注册 / 登录#xff08;个人账号权限受限#xff0c;跨境 / 商品类接口多为企业专属#xff…一、接入前准备必须完成1. 注册与认证账号与资质访问MIC 开放平台https://open.made-in-china.com/用企业账号注册 / 登录个人账号权限受限跨境 / 商品类接口多为企业专属完成企业实名认证营业执照、法人信息、对公账户核验1–3 个工作日开通API 服务权限在控制台「API 服务」→「申请开通」选择你需要的能力包商品搜索、商品详情、类目、榜单等2. 创建应用获取核心凭证进入「应用管理」→「创建应用」应用名称自定义如 “MIC 商品数据工具”应用类型自用型 / 第三方应用自用即可回调 URLOAuth 授权用本地调试可填http://localhost审核通过后在应用详情页获取三大核心凭证务必妥善保管严禁泄露app_key/client_id应用唯一标识app_secret/client_secret签名密钥access_token接口调用令牌通过 OAuth 获取有效期通常 24 小时3. 申请接口权限进入「权限管理」→「申请 API 权限」搜索并勾选你需要的接口以商品 / 类目 / 榜单为例商品类目category.get获取类目树商品搜索 / 榜单product.search、product.topList商品详情product.get提交审核公开权限一般即时通过高阶权限可能 1–2 个工作日。二、核心技术流程鉴权与签名MIC 通用规则MIC 接口采用OAuth2.0 MD5 签名双重校验所有请求必须带合法签名与令牌。1. 获取 access_token授权流程1获取授权码 codeplaintextGET https://open.made-in-china.com/oauth/authorize ?client_id你的app_key redirect_uri你的回调URL response_typecode state随机字符串(防CSRF)用户授权后平台会重定向到你的redirect_uri并带回code。2用 code 换取 access_tokenplaintextPOST https://open.made-in-china.com/oauth/token Content-Type: application/x-www-form-urlencoded grant_typeauthorization_code client_id你的app_key client_secret你的app_secret code上一步获取的code redirect_uri你的回调URL返回示例JSONjson{ access_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..., expires_in: 86400, refresh_token: xxx..., token_type: bearer }2. 生成签名MD5必对签名规则与 1688 类似但参数拼接略有差异把所有非空请求参数不含sign、不含文件按参数名 ASCII 升序排列按key1value1key2value2...拼接成字符串首尾拼接app_secretapp_secret 参数字符串 app_secret做MD5 加密转大写得到sign示例Pythonpython运行import hashlib def generate_mic_sign(params, app_secret): # 1. 按key升序排序 sorted_items sorted(params.items(), keylambda x: x[0]) # 2. 拼接 keyvaluekeyvalue... param_str .join([f{k}{v} for k, v in sorted_items if v is not None]) # 3. 首尾加secret sign_raw app_secret param_str app_secret # 4. MD5大写 sign hashlib.md5(sign_raw.encode(utf-8)).hexdigest().upper() return sign三、接口调用实战以 “获取商品类目 类目榜单” 为例1. 通用请求规范请求地址https://api.made-in-china.com/rest/{version}/{interface}版本v1或v2以文档为准目前主流v2请求方式GET查询类/POST提交类必传公共参数所有接口都要参数名类型必填说明app_keystring是应用 IDtimestamplong是13 位毫秒时间戳noncestring是随机字符串防重放如 UUIDsignstring是MD5 签名大写access_tokenstring是授权令牌formatstring否默认 json2. 接口 1获取商品类目树category.get请求示例Pythonpython运行import requests import time import uuid # 配置 APP_KEY 你的app_key APP_SECRET 你的app_secret ACCESS_TOKEN 你的access_token API_URL https://api.made-in-china.com/rest/v2/category.get def get_mic_category_tree(parent_id0): # 业务参数 params { app_key: APP_KEY, timestamp: int(time.time() * 1000), nonce: str(uuid.uuid4()), access_token: ACCESS_TOKEN, parent_id: parent_id, # 0顶级类目 format: json } # 生成签名 params[sign] generate_mic_sign(params, APP_SECRET) # 发送请求 resp requests.get(API_URL, paramsparams, timeout10) return resp.json() # 调用获取顶级类目 if __name__ __main__: result get_mic_category_tree(parent_id0) print(result)响应结构关键字段json{ code: 200, message: success, data: { categories: [ { category_id: 1001, name: Apparel, level: 1, is_leaf: false, children: [...] } ] } }3. 接口 2按类目获取商品榜单product.topList业务参数核心category_id类目 ID从上一步获取sort_type排序类型sales 销量price 价格newest 新品page_no/page_size分页country目标市场可选如 US、DE调用示例关键代码python运行API_TOP_URL https://api.made-in-china.com/rest/v2/product.topList def get_category_top_products(category_id, sort_typesales, page_no1, page_size20): params { app_key: APP_KEY, timestamp: int(time.time() * 1000), nonce: str(uuid.uuid4()), access_token: ACCESS_TOKEN, category_id: category_id, sort_type: sort_type, page_no: page_no, page_size: page_size, format: json } params[sign] generate_mic_sign(params, APP_SECRET) resp requests.get(API_TOP_URL, paramsparams, timeout10) return resp.json()四、限流、异常与最佳实践1. 限流规则必须遵守国内 IPQPS ≤ 10海外 IPQPS ≤ 5单日调用限额基础权限一般 5000–10000 次企业版可提升触发限流返回429 Too Many Requests需做退避重试1s→3s→5s最多 3 次2. 常见错误码与处理错误码含义处理方案400参数错误 / 签名错误核对参数顺序、签名逻辑、时间戳401token 过期 / 无效刷新 access_token 或重新授权403权限不足检查接口权限是否开通404类目 / 商品不存在核对 ID 有效性429限流本地限流 退避重试500服务异常缓存兜底重试 1 次失败告警3. 生产优化建议缓存类目数据类目更新慢本地缓存 24 小时减少调用令牌池 / 自动刷新提前刷新access_token避免过期中断字段过滤用fields参数只返回需要的字段提升性能日志与监控记录请求耗时、成功率、错误码便于排查五、与 1688 接口的关键差异避坑授权体系MIC 强依赖access_token1688 部分公开接口可仅用签名参数拼接MIC 用keyvalue分隔1688 是直接keyvalue无分隔符限流粒度MIC 按 IP 地域区分 QPS1688 按应用维度类目结构MIC 类目 ID 为字符串层级用level显式标注更适合跨境场景六、下一步行动先在 MIC 开放平台完成企业认证 应用创建 权限申请用 Postman 先调试category.get拿到类目 ID再调用product.topList验证类目榜单数据最后集成到你的系统加上缓存、限流、异常兜底