- 回调 method 由 snake_case 事件名改为 模块.动作:entryorder.confirm / entryorder.match / deliveryorder.confirm / stockout.confirm / deliveryorder.cancel(原 order.cancel 与入站方法同名,改名避免 callback_url 误指向 /openapi 时被路由到取消单据接口)。
- 时间戳统一为秒级(String(Math.floor(Date.now()/1000))),与 /openapi 入站 ±600 秒时效校验及回调调试页一致。
- 报文体由 { event, data, metadata } 改为奇门同层级 { request: {...} }(移除 metadata,事件标识只靠 query 的 method);入库类回调与奇门侧共用同一份报文组装。
- deliveryorder.confirm 改为逐单发送(仅同步成功的订单);stockout.confirm 直接复用 buildStockoutConfirmDataInternal 结果。
- 修复 entryorder.match 死代码:绑定成功且本次新建绑定时回传,重复触发不重复通知,回传失败不影响绑定。
- 调试页 /docs/api/openapi/callback-test 按真实报文预填;新增出站回调文档页 /docs/api/openapi_callback 及入口链接。
- script/update-api-doc.cjs 支持 spec.newDoc 新建文档与 docMeta.description(附单测)。
- 文档:methods/openapi_callback.json、AI_METHOD_ROUTING.md 5.6 节、docs/openapi-callback-events.md、docs/api-doc-update-workflow.md 等。
74 lines
2.6 KiB
JavaScript
74 lines
2.6 KiB
JavaScript
/**
|
|
* @param {Egg.Application} app - egg application
|
|
*/
|
|
module.exports = app => {
|
|
const { router, controller } = app;
|
|
router.get('/', controller.home.index);
|
|
router.get('/auth/platformOauthCallback', controller.home.platformOauthCallback);
|
|
router.get('/auth/platformOauthBind', controller.home.platformOauthBind);
|
|
router.get('/query/pddCode/:code', controller.home.queryPddCode);
|
|
|
|
// 内部网关接口
|
|
router.post('/internal/v1/gateway', controller.gateway.internal);
|
|
|
|
// 奇门接口
|
|
router.post('/qimen', controller.home.qimen);
|
|
|
|
// 系统接口 PDA/WEB 统一入口
|
|
router.post('/system', controller.home.system);
|
|
|
|
|
|
// 仅开发环境可访问的内部api文档
|
|
if (app.config.env === 'local') {
|
|
// api文档相关
|
|
router.get('/api/docs', controller.docs.list);
|
|
router.get('/api/docs/:docName/raw', controller.docs.raw);
|
|
router.get('/api/docs/:docName/changes', controller.docs.changes);
|
|
router.get('/api/docs/:docName', controller.docs.detail);
|
|
|
|
// 独立 docs 目录挂载 — 首页
|
|
router.get('/docs', controller.docs.docsIndex);
|
|
}
|
|
|
|
// OpenAPI 文档 — 所有环境均可访问,必须在通配路由之前注册
|
|
router.get('/docs/api/openapi', controller.docs.openapi);
|
|
|
|
// Warehouse 开放 API 文档 — 所有环境均可访问
|
|
router.get('/docs/api/warehouse', controller.docs.warehouse);
|
|
|
|
// OpenAPI 回调测试 — 所有环境均可访问的独立调试页面
|
|
router.get('/docs/api/openapi/callback-test', controller.openapiCallback.testPage);
|
|
|
|
// OpenAPI 出站回调文档 — 所有环境均可访问
|
|
router.get('/docs/api/openapi_callback', controller.docs.openapiCallbackEvents);
|
|
|
|
// 仅开发环境可访问的 docs 通配路由(静态文件),必须在 /docs/api/openapi 之后注册
|
|
if (app.config.env === 'local') {
|
|
router.get('/docs/:relPath(.*)', controller.docs.docsFile);
|
|
}
|
|
|
|
// OpenAPI 入口
|
|
router.post('/openapi', controller.openapi.index);
|
|
|
|
// 仓库 OpenAPI 入口
|
|
router.post('/warehouse', controller.warehouse.index);
|
|
|
|
// 打印模板
|
|
router.get('/template/xml/:id', controller.template.xml);
|
|
|
|
// 打印自定义区模板(抖音面单等)
|
|
router.get('/mb/douyin1.xml', controller.template.douyinCustomArea);
|
|
|
|
// 打印台设置
|
|
router.get('/auth/printSetting/:code', controller.auth.printerSetting);
|
|
router.post('/auth/printSetting/', controller.auth.printerSetting);
|
|
|
|
// 临时 fileWriter 消费入口
|
|
router.get('/__temp/file-writer/consume', controller.tempFileWriter.consume);
|
|
|
|
// 测试接口
|
|
router.get('/testSendData', controller.home.testSendData);
|
|
// IM交互入口
|
|
router.post('/im', controller.im.index);
|
|
};
|