alibaba.damai.mz.project.list (项目列表API)

麦座票务平台-自建电商网站-项目列表API; 麦座无座演出数据结构:项目->场次->票档; 麦座有座演出数据结构:项目->场次->票档->座位;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
first_class_id String 可选 19737107001
  • 最大长度:20
  • 一级项目分类id;
    second_class_id String 可选 19737107001003
  • 最大长度:20
  • 二级项目分类id;一级分类&二级分类 均传时以二级分类为准;
    page_size Number 可选 10 每页条数;默认=10;
    page Number 可选 1 当前页码;默认=1
    contains_count_down Boolean 可选 true 是否包含倒计时项目

    响应参数

    名称 类型 示例值 描述
    result ResultData 返回结果
    • └ msg
    • String
    • 错误
    • 提示
    • data
    • Pager
    • 返回分页数据
    • data_list
    • ProjectVO []
    • 返回数据列表
    • └ project_img_url
    • String
    • https://xxx.jpg
    • 项目海报图片地址;可空
    • └ second_class_id
    • String
    • 19737107001003
    • 二级项目分类id;可空
    • └ first_class_id
    • String
    • 19737107001
    • 一级项目分类id
    • └ project_sale_state
    • Number
    • 2
    • 项目销售状态;1待销售 2=销售中 3=取消;
    • └ project_seat_type
    • Number
    • 1
    • 项目座位类型;1=有座自助选座,2=无座
    • └ project_name
    • String
    • 开心麻花经典爆笑舞台剧《乌龙山伯爵》
    • 项目名称
    • └ project_id
    • String
    • 7386312015302
    • 项目id
    • └ first_class_name
    • String
    • 话剧歌剧
    • 一级项目分类名称
    • └ second_class_name
    • String
    • 话剧
    • 二级项目分类名称
    • └ project_round
    • String
    • 1
    • 项目轮次
    • sponsor_info_list
    • SponsorInfo []
    • 项目主办信息;可为空或多个;
    • └ sponsor_name
    • String
    • 主办方名称
    • 主办方名称
    • └ sponsor_id
    • Number
    • 3012313112
    • 主办方id
    • └ count_down_end_time
    • Date
    • 1567868000
    • 倒计时结束时间
    • └ count_down_sms_reminder
    • Boolean
    • true
    • 倒计时场次是否开启了短信提醒
    • └ count_down_state
    • String
    • 1
    • 倒计时项目状态;0取消 1倒计时中 2倒计时结束
    • └ total_page
    • Number
    • 2
    • 总页数
    • └ total_row
    • Number
    • 19
    • 总条数
    • └ page_size
    • Number
    • 10
    • 每页条数
    • └ page
    • Number
    • 1
    • 当前页码
    • └ code
    • String
    • 200
    • 状态码
    • └ success
    • Boolean
    • true
    • 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaDamaiMzProjectListRequest req = new AlibabaDamaiMzProjectListRequest();
    req.setFirstClassId("19737107001");
    req.setSecondClassId("19737107001003");
    req.setPageSize(10L);
    req.setPage(1L);
    req.setContainsCountDown(true);
    AlibabaDamaiMzProjectListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_damai_mz_project_list_response>
        <result>
            <msg>错误</msg>
            <data>
                <data_list>
                    <project_v_o>
                        <project_img_url>https://xxx.jpg</project_img_url>
                        <second_class_id>19737107001003</second_class_id>
                        <first_class_id>19737107001</first_class_id>
                        <project_sale_state>2</project_sale_state>
                        <project_seat_type>1</project_seat_type>
                        <project_name>开心麻花经典爆笑舞台剧《乌龙山伯爵》</project_name>
                        <project_id>7386312015302</project_id>
                        <first_class_name>话剧歌剧</first_class_name>
                        <second_class_name>话剧</second_class_name>
                        <project_round>1</project_round>
                        <sponsor_info_list>
                            <sponsor_info>
                                <sponsor_name>主办方名称</sponsor_name>
                                <sponsor_id>3012313112</sponsor_id>
                            </sponsor_info>
                        </sponsor_info_list>
                        <count_down_end_time>1567868000</count_down_end_time>
                        <count_down_sms_reminder>true</count_down_sms_reminder>
                        <count_down_state>1</count_down_state>
                    </project_v_o>
                </data_list>
                <total_page>2</total_page>
                <total_row>19</total_row>
                <page_size>10</page_size>
                <page>1</page>
            </data>
            <code>200</code>
            <success>true</success>
        </result>
    </alibaba_damai_mz_project_list_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>

    错误码解释

    错误码 错误描述 解决方案
    61001002 数据不存在 确认入参数据或参看API不传可选入参
    40100000 api未知错误 通用系统异常
    40100001 api请求失败 通用业务异常
    40100002 请求必须的参数不能为空 请求必须的参数不能为空
    40100003 请求数据不存在 请求数据不存在
    40100004 非法的appkey,请联系麦座小二 非法的appkey,请联系麦座小二
    40100005 每页条数参数超出限制值 每页条数参数超出限制值
    40100007 appkey商户配置不存在,请联系麦座小二 appkey商户配置不存在,请联系麦座小二
    40100008 出参数据不符合规范,请联系麦座小二 出参数据不符合规范,请联系麦座小二
    40100009 接口超时,请稍后重试 接口超时,请稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部