有赞新零售社区

发帖
API使用问题»礼品卡接口文档和实际调用获得信息不一致

[API调用-其它] 礼品卡接口文档和实际调用获得信息不一致

未来 06-05 1886 浏览 2 评论 | 只看楼主 [打印]
根据youzan.cardvoucher.giftcard.detail.query 接口文档描述 礼品卡状态值status值是
汇总卡状态;normal:正常,freeze:冻结,no_out:止出,no_in:止入,close:注销
https://doc.youzanyun.com/detail/API/0/606

5月bbs咨询回复 礼品卡status值为normal表示礼品卡可以使用和支付,下面是detail查询的礼品卡信息,查询信息礼品卡status值与接口文档和技术答复
https://bbs.youzan.com/forum.php?mod=viewthread&tid=700155

1、接口文档描述礼品卡status值与调用接口实际获取的不一致,见附件图片2。
请提供礼品卡status值有哪些? 哪些status值表示礼品卡可以支付?


2、查询发现还有卡是激活状态但是金额为0,见附件图片3,是否要获取到我们自己过滤能有效支付的礼品卡,请帮助给出过滤有效可支付卡的条件

3、在调用礼品卡接口发送请求时候 参数"page":1,"page_size":50,当用户如果卡有100张时候
是不是第一次调用根据"page":1,"page_size":50 是不是返回50张礼品卡信息?
第一次调用成功后,如何知道我们还要进行第二次查询后面50张礼品卡信息?





本帖最后由 未来 于 2025-6-4 20:28 编辑
用手机打开
收藏 ··· 回复
    尊敬的有赞用户 您好,我们已收到您的问题,并已安排相关技术支持正在处理中,请耐心等待。您可以关注之前预留的邮箱17433177@****** 注意问题解决进度提醒邮件。     请不要在帖子中暴露含有手机号、姓名、secret等敏感信息,如有必要帖子发布时候设置成回复仅发帖人可见。

      尊敬的开发者您好:
      1、辛苦提供一下这次调用接口返回给你的traceID(traceID是会在你调用接口会返回给你的一个字段,关于traceID你还可以参考文档:API日志排查工具:https://doc.youzanyun.com/doc#/content/27027/39835/51209)

      2、这个需要开发者在获取后自行过滤的哈,接口只是将数据返回。
      激活状态但金额为 0 的可能原因:
      卡激活后未充值
      卡内金额已全部消费
      建议通过储值流水接口查询消费记录

      3、当请求参数为 `"page":1,"page_size":50` 时:
      返回结果中的 `paginator.total_count` 字段会显示总条数
      若总条数超过 50,需继续查询 `page=2` 直到 `page_size*(page-1) >= total_count`
      示例:100 条数据需分 2 次查询(page1 返回 1-50 条,page2 返回 51-100 条)

        1跳至
        您需要登录后才可以回帖 登录 | 立即注册

        本版积分规则

        复制链接
        新浪微博
        QQ空间
        微信扫码
        • 回复

        • 评分

        客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

        复制成功