alibaba.latour.strategy.issue (阿里巴巴权益发放接口)

阿里巴巴权益平台权益发放接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
extra_data Json 可选 {} 扩展参数
failover_algorithm_result Boolean 可选 false
  • 默认值:false
  • 算法容灾
    idempotent_id String 可选 xxx 幂等id
    channel String 必须 xxx 发放渠道
    user_id String 可选 xxx 除非有特殊申请,默认不允许使用该参数,请通过用户授权token传递用户信息
    transformed_user_type String 可选 xxx 转换用户类型
    need_identify_risk Boolean 可选 false
  • 默认值:false
  • 是否需要过安全
    user_nick String 可选 xxx 除非有特殊申请,默认不允许使用该参数,请通过用户授权token传递用户信息
    strategy_code String 必须 xxx 投放计划code
    user_type String 可选 xxx 用户类型
    selected_benefit_code String 可选 xxx 指定发放权益code
    openid String 可选 xxx openid

    响应参数

    名称 类型 示例值 描述
    result Result {} 返回结果
    • └ code
    • String
    • LATOUR2-SYS-01
    • 错误码
    • data
    • StrategyIssueResultDto
    • 返回结果
    • └ display_amount_unit
    • String
    • 展示面额单位
    • └ extra_data
    • String
    • 扩展字段
    • └ issue_time
    • Date
    • 1569296900496
    • 发放时间
    • └ benefit_type
    • String
    • fpRedEnvelope
    • 权益类型
    • └ effective_start
    • Date
    • 1567071504000
    • 生效开始时间
    • └ effective_end_timestamp
    • Number
    • 1569859200000
    • 生效结束时间戳
    • └ outer_instance_id
    • String
    • 1260502084236286
    • 外部发放实例id
    • └ benefit_code
    • String
    • 99aa8f6c1a1b4bfe8789eaccf68725db
    • 权益code
    • └ effective_end
    • Date
    • 1569859200000
    • 生效结束时间
    • └ record_id
    • Number
    • 123
    • 中奖记录id
    • └ effective_start_timestamp
    • Number
    • 1567071504000
    • 生效开始时间戳
    • └ display_start_fee
    • String
    • 10
    • 展示门槛
    • └ amount
    • Number
    • 500
    • 面额
    • └ amount_unit
    • String
    • 面额单位
    • └ tracking_data
    • String
    • 追踪数据
    • └ display_amount
    • String
    • 5
    • 展示面额
    • └ effective_time_mode
    • String
    • ABSOLUTE
    • 生效时间类型
    • └ benefit_title
    • String
    • xxx
    • 权益标题
    • └ benefit_type_name
    • String
    • 现金红包
    • 权益类型名称
    • └ start_fee
    • Number
    • 1000
    • 门槛
    • └ effective_interval
    • Number
    • 1
    • 相对生效时间长度
    • └ interval_time_unit
    • String
    • SECONDS
    • 相对生效时间单位
    • └ material
    • String
    • 素材
    • └ msg
    • String
    • xxx
    • 错误描述
    • └ success
    • Boolean
    • true
    • 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaLatourStrategyIssueRequest req = new AlibabaLatourStrategyIssueRequest();
    req.setExtraDataString("{}");
    req.setFailoverAlgorithmResult(false);
    req.setIdempotentId("xxx");
    req.setChannel("xxx");
    req.setUserId("xxx");
    req.setTransformedUserType("xxx");
    req.setNeedIdentifyRisk(false);
    req.setUserNick("xxx");
    req.setStrategyCode("xxx");
    req.setUserType("xxx");
    req.setSelectedBenefitCode("xxx");
    req.setOpenid("xxx");
    AlibabaLatourStrategyIssueResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_latour_strategy_issue_response>
        <result>
            <code>LATOUR2-SYS-01</code>
            <data>
                <display_amount_unit>元</display_amount_unit>
                <extra_data></extra_data>
                <issue_time>1569296900496</issue_time>
                <benefit_type>fpRedEnvelope</benefit_type>
                <effective_start>1567071504000</effective_start>
                <effective_end_timestamp>1569859200000</effective_end_timestamp>
                <outer_instance_id>1260502084236286</outer_instance_id>
                <benefit_code>99aa8f6c1a1b4bfe8789eaccf68725db</benefit_code>
                <effective_end>1569859200000</effective_end>
                <record_id>123</record_id>
                <effective_start_timestamp>1567071504000</effective_start_timestamp>
                <display_start_fee>10</display_start_fee>
                <amount>500</amount>
                <amount_unit>分</amount_unit>
                <tracking_data></tracking_data>
                <display_amount>5</display_amount>
                <effective_time_mode>ABSOLUTE</effective_time_mode>
                <benefit_title>xxx</benefit_title>
                <benefit_type_name>现金红包</benefit_type_name>
                <start_fee>1000</start_fee>
                <effective_interval>1</effective_interval>
                <interval_time_unit>SECONDS</interval_time_unit>
                <material></material>
            </data>
            <msg>xxx</msg>
            <success>true</success>
        </result>
    </alibaba_latour_strategy_issue_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

    返回
    顶部