文档中心 > API类目 > 飞猪大交通顺风车api

alitrip.hitch.coupon.status.notify (顺风车优惠券状态变更)

顺风车优惠券状态变更

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
halo_promotion_coupon_sync_status_req HaloPromotionCouponSyncStatusReq 必须 入参
  • └ out_order_id
  • String
  • 必须
  • xxxxddddorderId
  • 渠道商订单号
  • └ coupon_pre_status
  • String
  • 必须
  • 1
  • 券变更前状态1-可用,2-锁定,3-核销,4-作废,6-已用完
  • └ event_time
  • Date
  • 必须
  • 2024-10-01 00:00:00
  • 事件发生时间
  • └ out_coupon_name
  • String
  • 可选
  • 券实例名称
  • 券实例名称
  • └ operation_type
  • String
  • 必须
  • 1
  • 操作类型 0-发放,1-锁定,2-核销,3-解锁,4-冲正,5-作废
  • └ out_coupon_id
  • String
  • 必须
  • 券实例ID
  • 券实例ID
  • └ out_coupon_status
  • String
  • 必须
  • 2
  • 券变更后状态 1-可用,2-锁定,3-核销,4-作废,6-已用完
  • └ ext_attr_map
  • String
  • 必须
  • 扩展参数,json格式
  • {}

响应参数

名称 类型 示例值 描述
biz_error_msg String 成功 返回信息
biz_success Boolean true 接口业务是否成功
biz_error_code String true 错误码,成功时为空

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripHitchCouponStatusNotifyRequest req = new AlitripHitchCouponStatusNotifyRequest();
AlitripHitchCouponStatusNotifyRequest.HaloPromotionCouponSyncStatusReq obj1 = new AlitripHitchCouponStatusNotifyRequest.HaloPromotionCouponSyncStatusReq();
obj1.setOutOrderId("xxxxddddorderId");
obj1.setCouponPreStatus("1");
obj1.setEventTime(StringUtils.parseDateTime("2024-10-01 00:00:00"));
obj1.setOutCouponName("券实例名称");
obj1.setOperationType("1");
obj1.setOutCouponId("券实例ID");
obj1.setOutCouponStatus("2");
obj1.setExtAttrMap("扩展参数,json格式");
req.setHaloPromotionCouponSyncStatusReq(obj1);
AlitripHitchCouponStatusNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_hitch_coupon_status_notify_response>
    <biz_error_msg>成功</biz_error_msg>
    <biz_success>true</biz_success>
    <biz_error_code>true</biz_error_code>
</alitrip_hitch_coupon_status_notify_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部