文档中心 > API类目 > 天猫超市前台API

alibaba.tmall.eps.oa.excode.generate (生成兑换码)

天猫企业购:生成兑换码

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
parms TopExCodeRequest 必须 请求入参
  • └ amount
  • String
  • 必须
  • 5
  • 生成数量,最多50个
  • └ point
  • String
  • 必须
  • 100
  • 单个兑换码面额
  • └ isv_corp_id
  • String
  • 必须
  • ding******64d335
  • ISV的cropId
  • └ corp_id
  • String
  • 必须
  • ding******64d335
  • 企业的cropId
  • └ unique_id
  • String
  • 必须
  • eWbAKTBmPZHecgBFEmesKLNGI1iBRaNf
  • 幂等ID
  • └ fund_type
  • String
  • 可选
  • ent_point
  • 元宝权益类型

响应参数

名称 类型 示例值 描述
result Result 0 接口返回model
  • datas
  • Data []
  • 0
  • 结果 集
  • └ create_time
  • Number
  • 1617890097000
  • 创建时间戳
  • └ ex_time
  • Number
  • 1617890097000
  • 兑换时间戳
  • └ expire_date
  • Number
  • 1617890097000
  • 过期时间戳
  • └ state_text
  • String
  • 已创建
  • 状态文案
  • └ state
  • String
  • INIT
  • 状态
  • └ biz_uuid
  • String
  • eWbAKTBmPZHecgBFEmesKLNGI1iBRaNf
  • 批次
  • └ point
  • Number
  • 10
  • 面额
  • └ ex_code
  • String
  • eWbAKTBmPZHecgBFEmesKLNGI1iBRaNf
  • 兑换码
  • └ message
  • String
  • 1
  • message
  • └ success
  • String
  • true
  • 是否成功
  • └ code
  • String
  • 1
  • code

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTmallEpsOaExcodeGenerateRequest req = new AlibabaTmallEpsOaExcodeGenerateRequest();
AlibabaTmallEpsOaExcodeGenerateRequest.TopExCodeRequest obj1 = new AlibabaTmallEpsOaExcodeGenerateRequest.TopExCodeRequest();
obj1.setAmount("5");
obj1.setPoint("100");
obj1.setIsvCorpId("ding******64d335");
obj1.setCorpId("ding******64d335");
obj1.setUniqueId("eWbAKTBmPZHecgBFEmesKLNGI1iBRaNf");
obj1.setFundType("ent_point");
req.setParms(obj1);
AlibabaTmallEpsOaExcodeGenerateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_tmall_eps_oa_excode_generate_response>
    <result>
        <datas>
            <data>
                <create_time>1617890097000</create_time>
                <ex_time>1617890097000</ex_time>
                <expire_date>1617890097000</expire_date>
                <state_text>已创建</state_text>
                <state>INIT</state>
                <biz_uuid>eWbAKTBmPZHecgBFEmesKLNGI1iBRaNf</biz_uuid>
                <point>10</point>
                <ex_code>eWbAKTBmPZHecgBFEmesKLNGI1iBRaNf</ex_code>
            </data>
        </datas>
        <message>1</message>
        <success>true</success>
        <code>1</code>
    </result>
</alibaba_tmall_eps_oa_excode_generate_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

返回
顶部