开放平台
    开放平台
    • 首页
    • App/H5对接流程:
    • API开放接口对接流程
    • 小程序对接流程v1.0
    • 数据推送说明
    • 基础信息
      • 获取接口访问令牌
        POST
      • 更改密码
        POST
      • 企业用户信息 v1.1
        GET
      • 获取会员token
        POST
    • 电影票接口
      • 电影票回调通知
      • 获取城市列表
        GET
      • 热映电影(pageIndex从0开始)
        GET
      • 即将上映电影
        GET
      • 获取影院列表
        GET
      • 获取影院过滤列表(获取城市影院品牌和区域信息)
        GET
      • 获取电影的影院列表
        GET
      • 获取电影详情
        GET
      • 获取影院某个电影的排片列表
        GET
      • 获取电影场次(座位)详情
        GET
      • 创建订单
        POST
      • 订单简要信息(字段较简洁,用于发起订单支付)
        GET
      • 支付订单(用户付款成功后调用)
        GET
      • 订单列表(管理)
        POST
      • 订单详情
        GET
      • 获取广告列表
        GET
    • 吃喝玩乐接口
      • GroupBuy
        • 城市列表
        • 商品列表
        • 商品详情
      • GroupBuyOrder
        • 下单(自己做产品展示,才需要下单接口)
        • 订单支付通知
        • 订单列表
        • 订单详情
        • 订单详情(管理)
    • 购物接口
      • FanLiOrder
        • 订单列表
        • 订单详情(管理)
    • 卡券接口
      • GiftCard
        • 卡券商品分类列表
        • 卡券商品列表
        • 商品详情
        • 下单(自己做产品展示,才需要下单接口)
        • 订单支付通知
        • 订单列表
        • 订单详情
        • 卡券商品按类别列表(共二级分类)
    • 点餐接口
      • 点餐回调通知
      • 城市列表
      • 平台店铺列表
      • 店铺详情,如果传了经纬度,返回距离
      • 菜单
      • 商品详情(不同品牌商品详情会有所不同)
      • 创建订单(不同品牌的商品详情下单的参数会有所不同)
      • 订单支付通知(用户付款成功后调用)
      • 订单列表
      • 订单详情
      • 订单上传文件列表
    • 礼金接口
      • PayCouponBind
        • 通过手机号发放优惠劵

    小程序对接流程v1.0

    📌
    1、在小程序后台添加有票票的业务域名:
    https://www.youpiaopiao.cn
    https://7moor.youpiaopiao.cn (如果有自己的独立客服系统,不需要添加)
    https://static.aihecong.com/ (如果有自己的独立客服系统,不需要添加)
    2、和有票票对接人员获取接口参数,在接口调用,URL拼接等地方会使用到这些参数 注:有特殊参数符号的参数要通过urlencode来处理
    参数名说明
    entid唯一id标识
    appSecret密钥
    appId应用id,可以创建多个
    source同appId,主要用在前端url参数
    entpara自定义参数,回传数据时原样返回
    token我方与对接方用户数据对接依据,从接口/api/oauth/member_token获取,用对接方的userId或者手机号来换取member_token,接口文档获取会员token
    pushUrl回调推送地址(非必填),用于订单状态变化时推送订单信息到对接方的地址,带上这个参数将覆盖全局配置里的推送地址。 该参数目前仅支持点餐业务场景,电影的推送地址需要联系运营配置推送地址。 示例:&pushUrl=xxxx 注:回调推送的URL链接一定要做编码处理
    lat lng经纬度 (非必填)注:虽然是非必填但是小程序对接进来一定要传坐标。示例值:&lat=xxx&lng=xxx
    3、小程序里面创建WebView,src赋值为有票票的页面地址
    注:在使用以下链接时,请确保对动态参数进行 URL 编码(URL Encoding),以避免因特殊字符(如 &, =, % 等)导致链接解析错误。
    页面 地址
    首页 https://www.youpiaopiao.cn/h10/#/?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影 https://www.youpiaopiao.cn/h10/#/pages/movie/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    吃喝玩乐 https://www.youpiaopiao.cn/h10/#/pages/groupbuy/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}&ig=0
    电影订单 https://www.youpiaopiao.cn/h10/#/pages/order/movie/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    大牌点餐集合页 https://www.youpiaopiao.cn/h10/#/pages/food/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    肯德基单页(可外卖) https://www.youpiaopiao.cn/h10/#/pages/food/kfc/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    麦当劳单页(可外卖) https://www.youpiaopiao.cn/h10/#/pages/food/mdl/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    瑞幸单页 https://www.youpiaopiao.cn/h10/#/pages/food/rx/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    奈雪单页 https://www.youpiaopiao.cn/h10/#/pages/food/nx/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    喜茶单页 https://www.youpiaopiao.cn/h10/#/pages/food/xc/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    星巴克单页(可外卖) https://www.youpiaopiao.cn/h10/#/pages/food/xbk/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    点餐订单详情页 https://www.youpiaopiao.cn/h10/#/pages/pay/kfcDetailPay?orderId={xx}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影购买页 https://www.youpiaopiao.cn/h10/#/pages/movie/cinema?coming=0&movieId={电影id}&movieName={电影名称}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    电影详情页 https://www.youpiaopiao.cn/h10/#/pages/movie/movieInfo?coming=0&movieId={电影id}&entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    卡券 https://www.youpiaopiao.cn/h10/#/pages/giftcard/index?entid={entid}&source={appId}&entpara={entpara}&token={member_token}
    地址URL参数说明
    参数名 说明
    entid 唯一id标识,有票票提供的接口参数
    source 应用id,有票票提供的接口参数
    entpara 自定义参数,此参数会体现在用户订单里面
    token 双方用户数据对接依据,从接口/api/oauth/member_token获取,用对接方的userId或者手机号来换取member_token
    lat 坐标参数,如果没有传坐标参数,将使用ip地址来模糊定位
    lng 坐标参数,如果没有传坐标参数,将使用ip地址来模糊定位
    4、接口对接
    实时在线接口文档,可在线调试,包含有完整的参数样例、返回参数模型,CURL调用样例等
    我方接口更新,本说明文档可能不会第一时间更新,但是会实时反馈到在线接口文档
    注意事项
    除了获取接口访问令牌/api/oauth/token),其余所有接口调用都需要带上token,也就是在header里带上Authorization:Bearer {access_token},注意,Bearer后面有空格
    请求参数使用json格式,在header里带上:Content-Type:application/json,返回数据也是json格式,code=0表示接口调用成功,其余为失败,返回数据统一格式:
    获取页面地址Url里面的{member_token}参数,需调用有票票的接口
    获取会员token:
    订单有超时未付取消机制,电影订单时10分钟,其他订单时20分钟;要注意,超时的订单就不要让用户支付了,如果超时支付,会照成你们收了用户的钱,但在我们这边支付订单失败。
    5、创建小程序页面
    01、创建支付页面
    创建以下名称的小程序页面,用于发起用户微信支付 :
    小程序支付页面地址:
    用户支付完成,对接方收到微信支付通知成功后,调用有票票的的支付通知接口
    如需下测试单,在调用支付通知接口的时候传参数test=true的时候订单会自动拦截,不会产生正式订单。
    电 影 票订单支付通知:支付订单(支付成功后调用)/api/movie/pay_order
    吃喝玩乐订单支付通知: 订单支付通知/api/groupbuy_order/pay_order
    卡 券 订 单支付通知:订单支付通知/api/gift_card/pay_order
    肯德基/麦当劳/星巴克单支付通知:订单支付通知/api/kfc/pay_order
    跳转参数说明
    参数名 说明
    orderId 订单id,拿到订单id后请调用接口获取订单应付金额等信息
    type 订单类型,0电影订单,1卡券订单,4吃喝玩乐订单,5肯德基/麦当劳/星巴克
    returnUrl 有票票的订单详情页,如果入款完成,可以选择跳转回此页面
    02、创建点餐外卖地址选择页面:
    用户选择完地址后,会拿到经纬度和具体地址信息,然后赋值给address的lat lon addr 最后拼接在returnUrl的address返回给我们,完成地址的选择
    另外微信小程序还需要申请开通 “打开地图选择位置” 权限接口
    目前点餐外卖功能暂时只支持星巴克/麦当劳/肯德基
    6、创建后台接口对接有票票的数据推送
    详细的推送数据说明查看数据推送说明那篇文档。
    上一页
    API开放接口对接流程
    下一页
    数据推送说明
    Built with