alibaba.damai.mz.asset.verifycode.check (会员安全验证码验证)

大麦麦座会员账户或资产验证码验证API; 1、当自建电商网站使用会员积分、余额、礼品卡等资产时,必须先调用“会员资产验证码发送API”向消费者发送手机验证码; 2、消费者输入验证码执行校验调用本API获取资产使用业务key; 3、下单时使用会员资产时传入资产使用业务key即可; 4、资产使用业务key单次有效(除资产使用key输入错误外); 5、线上开通账户需要通过此接口获取验证码 6、线上修改账户支付密码需要通过此接口获取验证码 7、线上重置账户支付密码需要通过此接口获取验证码

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
verify_code String 必须 786192
  • 最大长度:8
  • 验证码;
    mz_user_id String 必须 18928818014 麦座用户id
    check_code_type Number 可选 1
  • 默认值:1
  • 1=资产使用验证码 2=线上开通账户验证码 3修改账户密码验证码 4=线上重置账户密码验证码

    响应参数

    名称 类型 示例值 描述
    result ResultData 请求结果
    • └ msg
    • String
    • 成功
    • 提示信息
    • └ code
    • String
    • 200
    • 状态码
    • data
    • VerifyCodeCheckVO
    • 资产验证结果信息
    • └ mz_user_id
    • String
    • 18928818014
    • 麦座用户id
    • └ asset_biz_key
    • String
    • yag8182h9hab182
    • 资产使用业务key;资产使用业务key单次有效,除下单时提示业务key错误外;12-16位字母+数字
    • └ key_expire_time
    • String
    • 2020-04-01 11:30:31
    • key过期时间;精确到秒,北京时间 UTC-8;格式:yyyy-MM-dd HH:mm:ss;建议接入方可比此时间短1min,防止临界异常情况;
    • └ success
    • Boolean
    • true
    • 请求结果是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaDamaiMzAssetVerifycodeCheckRequest req = new AlibabaDamaiMzAssetVerifycodeCheckRequest();
    req.setVerifyCode("786192");
    req.setMzUserId("18928818014");
    req.setCheckCodeType(1L);
    AlibabaDamaiMzAssetVerifycodeCheckResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_damai_mz_asset_verifycode_check_response>
        <result>
            <msg>成功</msg>
            <code>200</code>
            <data>
                <mz_user_id>18928818014</mz_user_id>
                <asset_biz_key>yag8182h9hab182</asset_biz_key>
                <key_expire_time>2020-04-01 11:30:31</key_expire_time>
            </data>
            <success>true</success>
        </result>
    </alibaba_damai_mz_asset_verifycode_check_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>

    错误码解释

    错误码 错误描述 解决方案
    40100000 api未知错误 通用系统异常
    40100001 api请求失败 通用业务异常
    40100002 请求必须的参数不能为空 请求必须的参数不能为空
    40100003 请求数据不存在 请求数据不存在
    40100006 请求必须的参数麦座会员id不能为空 请求必须的参数麦座会员id不能为空

    API工具

    如何获得此API

    FAQ

    返回
    顶部