# 查询礼物订单详情-旧

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:get_present_order

通过该接口查询小店授权送礼订单详情。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/order/presentorder/get?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用。

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

参数名类型必填说明
present_order_idnumber礼物单id
openidstring用户openid

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
present_order_infoobject礼物单详情

# Res.present_order_info Object Payload

礼物单详情

参数名类型说明
ecsgiftobject礼物详情信息
cannot_receivenumber能否收礼
cannot_receive_tipsstring不能收礼tips

# Res.present_order_info.ecsgift Object Payload

礼物详情信息

参数名类型说明枚举
giftsobject礼物列表-
wishmessagestring祝福语-
user_typenumber用户视角枚举值

# Res.present_order_info.ecsgift.gifts Object Payload

礼物列表

参数名类型说明
giftobjarray礼物信息列表

# Res.present_order_info.ecsgift.gifts.gift(Array) Object Payload

礼物信息列表

参数名类型说明枚举
orderidnumber礼物单id-
giftstatusnumber礼物状态枚举值
expired_timenumber礼物过期时间-

# 4. 枚举信息

# Res.present_order_info.ecsgift.user_type Enum

用户视角

枚举值描述
0第三者
1赠礼者
2收礼者

# Res.present_order_info.ecsgift.gifts.gift(Array).giftstatus Enum

礼物状态

枚举值描述
0待领取
1已领取
2已超时
3已领取待填地址
4礼物已领完
5未填地址超时
6未抽中

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

{
    "present_order_id": "4226341196275658752",
    "openid": "OPENID"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "present_order_info": {
        "ecsgift": {
            "gifts": {
                "gift": [
                    {
                        "order_id": 4226341196275658752,
                        "wishmessage": "祝福你",
                        "giftstatus": 0
                    }
                ]
            },
            "user_type": 1
        }
    }
}

# 7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述
40097参数错误

# 8. 适用范围

本接口在不同账号类型下的可调用情况:
小程序小游戏微信小店
  • ✔:该账号可调用此接口。
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。
接口变更日志(1条)
2025 年 12 月 08 日
【查询礼物订单详情】接口优化,需要更新为新接口