概述

本系统使用的“一号通”为 EBAOZU 自研一号通开放平台，用于统一对接第三方云服务，包括短信发送、物流快递轨迹查询、商品平台数据采集等功能。

IMPORTANT

关于一号通的重要说明： 系统中曾存在 CRMEB 原始一号通（已废弃并停用）。在 V4 系统中，所有外部云服务均统一对接 EBAOZU 自研一号通。

---

核心配置与服务

平台接入信息

• 开放平台地址：https://admin.ebaozu.cn
• 配置密钥：环境变量 PLAT_KEY（在 .env 或后台系统设置中配置）
• 核心业务层：app/services/third/
• 基类封装：app/services/third/ThirdBaseService.php

主要服务类清单

app/services/third/
├── ThirdBaseService.php       # 自研一号通基础服务（请求封装、签名、Token管理）
├── ThirdSmsServices.php       # 短信发送与模板服务
├── ThirdExpressServices.php   # 快递物流轨迹查询服务
├── ThirdProductServices.php   # 商品平台采集导入服务
└── ...

---

核心功能介绍

短信服务 (ThirdSmsServices)

用于用户注册、登录验证码、订单发货通知、逾期提醒等短信发送。

use app\services\third\ThirdSmsServices;

/** @var ThirdSmsServices $smsService */
$smsService = app()->make(ThirdSmsServices::class);

// 发送短信验证码
$smsService->send('13800138000', 'VERIFY_CODE', ['code' => '123456']);

物流快递查询 (ThirdExpressServices)

对接全国主流快递公司物流轨迹查询接口，支持实时轨迹推送与主动查询。

use app\services\third\ThirdExpressServices;

/** @var ThirdExpressServices $expressService */
$expressService = app()->make(ThirdExpressServices::class);

// 查询物流轨迹
$result = $expressService->query('SF', 'SF1234567890');

商品采集 (ThirdProductServices)

支持将第三方电商平台的商品链接一键解析并导入至系统草稿箱或商品库。

use app\services\third\ThirdProductServices;

/** @var ThirdProductServices $productService */
$productService = app()->make(ThirdProductServices::class);

// 采集商品
$productData = $productService->crawlProduct($url);

---

接入与二开规范

1. 统一继承基类：所有新增一号通子功能必须继承 ThirdBaseService，通过统一的 HTTP Client 和鉴权机制请求。
2. 密钥管理：严禁在代码中硬编码 PLAT_KEY，必须通过 env('PLAT_KEY') 或系统配置读取。
3. 错误处理：第三方接口异常需统一捕获并记录日志，避免因第三方接口超时影响核心下单与支付主链路。