当前位置：首页 > news >正文

跨境电商如何接入1688官方寻源通接口？附接入流程

news 2026/6/9 5:17:21

一、接入前提（资质要求）

主体：必须是企业 / 个体工商户（个人账号无法申请）
业务：跨境电商、跨境 ERP、独立站、跨境供应链服务相关
考核门槛（2026 新规）【GMV达不到可考虑接入第三方官方合作】
- 月成交额 ≥12 万元（通过寻源通 API 产生的确认订单）
- 调用效率 ≥0.5 元 / 次（总成交额 ÷ 总调用次数）
- 不达标会被限流 / 清退

二、完整接入流程（7 步）

1. 注册 1688 开放平台企业开发者

访问：
open.1688.com
File
用企业 1688 账号登录 → 注册为企业开发者
完成企业实名认证：
- 营业执照
- 法人身份证
- 企业对公账户验证

2. 创建应用 & 申请寻源通权限

控制台 →应用管理 → 创建应用
- 应用名称：如「XX 跨境 ERP - 寻源通」
- 应用类型：企业应用 / 跨境电商类
- 应用场景：跨境选品 / 跨境供应链 / 跨境订单同步（必须写跨境相关）
API 权限申请
- 进入API 市场 → 跨境寻源通
- 勾选所需接口：
  - crossBorder.product.search（跨境商品搜索）
  - crossBorder.product.get（商品详情）
  - crossBorder.supplier.get（供应商资质）
  - crossBorder.order.create（跨境订单创建）
  - crossBorder.order.list（订单 / 物流）
- 提交审核（1–3 个工作日）

3. 获取密钥（appKey /appSecret）

审核通过后，在应用详情页获取：

appKey：应用 ID
appSecret：签名密钥（严格保密）

4. 授权机制（获取 AccessToken）

寻源通采用OAuth 2.0 授权

授权 URL（前端跳转）

plaintext

https://open.1688.com/auth/authorize.htm ?response_type=code &client_id={appKey} &redirect_uri={回调地址} &state=自定义 &scope=crossBorder

通过 code 换取 AccessToken（后端）

plaintext

POST https://open.1688.com/auth/token.htm 参数： grant_type=authorization_code client_id={appKey} client_secret={appSecret} code=上一步返回的code redirect_uri={回调地址}

返回：access_token、refresh_token、有效期（通常7 天）

5. 接口签名规则（必看）

所有接口调用需签名（sign）

python

运行

# Python 示例 import hashlib import time def generate_sign(params, app_secret): # 1. 按key排序 sorted_params = sorted(params.items()) # 2. 拼接字符串 concat_str = app_secret for k, v in sorted_params: concat_str += f"{k}{v}" concat_str += app_secret # 3. MD5加密 → 大写 sign = hashlib.md5(concat_str.encode()).hexdigest().upper() return sign # 公共参数示例 timestamp = str(int(time.time() * 1000)) public_params = { "app_key": "YOUR_APP_KEY", "timestamp": timestamp, "format": "json", "v": "2.0", "sign_method": "md5" }

6. 接口调用示例（跨境商品搜索）

python

运行

import requests # 1. 构造请求参数 method = "crossBorder.product.search" access_token = "YOUR_ACCESS_TOKEN" biz_params = { "keyword": "wireless earbuds", "pageSize": 20, "page": 1, # 跨境筛选 "crossBorderType": "direct", # 支持跨境直发 "certification": "CE,FDA", # 合规认证 "targetMarket": "EU" # 目标市场 } # 2. 合并参数 + 签名 all_params = {**public_params, "method": method, "access_token": access_token, **biz_params} all_params["sign"] = generate_sign(all_params, "YOUR_APP_SECRET") # 3. 发起请求 url = "https://open.1688.com/api/rest" resp = requests.post(url, data=all_params) result = resp.json()

7. 测试 → 上线 → 运维

沙箱测试：开放平台提供测试环境验证流程
正式调用：审核通过 → 切换正式环境
监控：
- 调用量、成功率、耗时
- 每月考核指标（成交额、调用效率）
异常处理：
- access_token过期自动刷新
- 限流、降级、重试机制

三、核心接口清单（跨境专用）

商品寻源
- crossBorder.product.search：跨境商品搜索（关键词、价格、销量、认证、市场）
- crossBorder.product.get：商品详情（SKU、库存、价格、跨境属性、认证）
供应商
- crossBorder.supplier.get：供应商资质（是否工厂、诚信通、跨境能力）
订单 & 物流
- crossBorder.order.create：创建跨境订单
- crossBorder.order.list：订单列表、状态、物流单号
- crossBorder.logistics.get：物流跟踪