POST/mpOrder/getOrderDetail小程序

获取订单详情 · getOrderDetail 推断名·方法名推断

C 端聚合接口 / 订单· MpOrderController#getOrderDetail

基本信息

  • 接口状态前端在用 置信度 高 免鉴权
  • 接口URLPOSThttps://dscp-dev.hn12301.net/mp-api/mpOrder/getOrderDetail
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道小程序 前缀 /mp-api
  • 名称来源方法名推断 补 javadoc 后自动转正
  • 调用方已确认在用 · 爱上萍乡 小程序(1 个前端)
  • 需求上下文feat: add MpOrder query API (queryOrderList + getOrderDetail)
  • 维护人 / 最后改动jacobxu666 2026-06-30 最近提交:feat: add MpOrder query API (queryOrderL
  • 读写数据表openapi_channel_card 反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.zhy.mp.MpOrderController#getOrderDetail
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/zhy/mp/MpOrderController.java:33
  • 判定依据1 个调用点:pingxiangcard/src/packages/user/pages/order/detail.vue

请求参数

Header 请求参数

参数名参数值是否必填参数类型描述说明
无(渠道统一鉴权头见《认证方式》)

Query 请求参数

参数名参数值是否必填参数类型描述说明
无

路径参数及说明

参数名参数值是否必填参数类型描述说明
无

Body 请求参数

Body 类型 MpOrderDetailRequest
参数名参数值是否必填参数类型描述说明
phone…是StringPattern regexp = "^1[3-9]\\d{9}$", message = "手机号格式不正确"
orderId…是String → openapi_channel_card.order_id

认证方式

免鉴权:@Route(auth = false) —— 该接口不校验登录态,改动前确认调用方与签名校验。

响应参数

data 类型 MpOrderDetailResponse
参数名参数值是否必填参数类型描述说明
id…否String → openapi_channel_card.id
payStatus…否Integerxuchao: 支付状态:1=待支付 2=已支付 3=已退款
orderStatus…否Integerxuchao: 订单状态:1=待确认 2=待发货 3=已发货 4=已完成 5=已取消
cardNo…否Stringxuchao: 卡号(openapi_channel_card.card_no) → openapi_channel_card.card_no
isBind…否Integerxuchao: 是否绑定(openapi_channel_card.is_bind) → openapi_channel_card.is_bind
createTime…否String
payTime…否String
payAmount…否Integer
redeemCode…否String
payChannel…否String
activatedTime…否String
refundedTime…否String
bindName…否Stringxuchao: 绑定人姓名(openapi_channel_card.bind_name) → openapi_channel_card.bind_name
bindCertificateNo…否Stringxuchao: 绑定证件号(openapi_channel_card.bind_certificate_no) → openapi_channel_card.bind_certificate_no
validStartDate…否Stringxuchao: 有效期开始(openapi_channel_card.valid_start_date) → openapi_channel_card.valid_start_date
validEndDate…否Stringxuchao: 有效期结束(openapi_channel_card.valid_end_date) → openapi_channel_card.valid_end_date
cardStatus…否Integerxuchao: 卡状态(openapi_channel_card.card_status) → openapi_channel_card.card_status
isActive…否Integerxuchao: 是否激活(openapi_channel_card.is_active) → openapi_channel_card.is_active
thirdOrderNo…否String
orderPhone…否String
cardState…否Integer

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "\"string\"",
    "payStatus": "1",
    "orderStatus": "1",
    "cardNo": "\"string\"",
    "isBind": "1",
    "createTime": "\"string\"",
    "payTime": "\"string\"",
    "payAmount": "1",
    "redeemCode": "\"string\"",
    "payChannel": "\"string\"",
    "activatedTime": "\"string\"",
    "refundedTime": "\"string\""
  }
}

失败响应示例

{
  "data": null,
  "可能返回": [
    {
      "errcode": "90002",
      "errmsg": "请求参数不合法"
    },
    {
      "errcode": "99999",
      "errmsg": "服务内部错误"
    }
  ]
}
示例来自源码/导出内容,仅结构参考,非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:openapi_channel_card 反查全部引用接口 →
  • MpOrderController#getOrderDetail
  • MpOrderService#getOrderDetail(MpOrderServiceImpl)
  • MpOrderMapper#getOrderDetail
逻辑摘要:查询详情(mpOrderService.getOrderDetail)
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)
调用点证据
  • pingxiangcard/src/packages/user/pages/order/detail.vue:177 爱上萍乡 小程序 · res
可能抛出的业务码:90002 请求参数不合法、99999 服务内部错误 错误码字典 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据