聚合数据

通用礼品卡接口文档

  • 数据类型: 充值缴费
  • 接口状态: 正常
  • 已连接App的数量: 5590
  • 描述: 集于各商家实体卡和会员卡的API虚拟卡,可用于线上/下消费、移动支付。

接口地址: http://v.juhe.cn/giftCard/products

支持格式: json/xml

请求方式: http get/post

请求示例: http://v.juhe.cn/giftCard/products

请求参数:

名称 类型 必填 说明
​dtype string 返回的格式,json或xml,默认json
key string 您申请到的APPKEY

返回字段:

名称 类型 说明
​error_code int 返回码
reason string 返回说明
result string 返回结果集

JSON返回示例:

/* 示例内容有所省略,请以您取到的最新数据为准 */
/* 商品ID基本不会变,请做好长期的缓存 */
/* 如果您的需求量较大,请告诉我们您需要的卡种以便我们备货 */
/* 如需各卡的使用说明,请访问 http://code.juhe.cn/docs/1944 */

{
  "reason": "查询成功",
  "result": [
    {
      "productId": "100026", /* 商品ID基本不会变,请做好长期的缓存 */
      "name": "携程任我行100元", /* 商品名 */
      "value": "100.00", /* 商品面值 */
      "discount": "0.998" /* 默认折扣,如您需求量较大,可议 */
    },
    {
      "productId": "100027",
      "name": "携程任我行500元",
      "value": "500.00",
      "discount": "0.998"
    },
   {
      "productId": "310001",
      "name": "阳澄湖牌出口有机大闸蟹298型", /* 优惠价格,企业采购,请咨询客服*/
      "value": "298.00",
      "discount": "0.900"
    },
    此处有省略
  ],
  "error_code": 0
}

XML返回示例:


          

备注:查询可购买的礼品卡的列表,及每个礼品卡对应的productId。如需了解各礼品卡的使用,请点击 <a href="http://code.juhe.cn/docs/1944" target="_blank">我</a>

服务级错误码参照(error_code):

错误码 说明
223100 系统错误
223101 参数输入错误
223102 您的余额不足
223103 库存不足
223104 没有权限购买该卡或超过最大限额

系统级错误码参照:

错误码 说明
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用

错误码格式说明(示例:200201):

2 002 01
服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

《通用礼品卡接口文档》资费说明:

等级 价格(元) 请求次数

其他相关内容:

内容 详细
接口测试 API测试工具
技术支持 info@juhe.cn
联系电话 0512-62391880
QQ交流群 264591694
在线客服QQ 1794844675
商务合作QQ 603866358