商展云官网

创建达人（达人）

通过开发接口创建

您可以通过该API接口直接创建达人(达人)账号，创建的账号可以直接用于商展云官网（5bms.com）的登录及查看自己的业绩。

对接前必读

正式环境地址为：https://www.5bms.com/
请求方式：POST
入参方式： Content-Type:application/x-www-form-urlencoded
所有接口均需要签名, 详情请看[基本参数及校验]

基本参数及校验

公共 Body 请求参数

参数名	类型	是否必须	描述说明
app_id	String	是否必须	app-id
sign	String	是	签名（详见“签名规则”）
time	Integer	是	当前10位时间戳

秘钥信息

请联系商务人员开通相关权限

签名规则

1、除[sign]以外，将所有参数按照键名排序

php-demo：


                                                $params = ['app_id'=>'13000000000','sign'=>'370B282C413E6EB3C83D1A20A02AEDA0','time'=>1693811486,'medium_id' => abc123456 'medium_name' => 测试 ....];

                                                $param = ksort($param);

2、遍历数组，将参数的key与value用[=]连接，得到字符串。再将所有得到的字符串用[&]连接，得到新字符串。以上述例子，得到的字符串为：$str = app_id=13000000000&medium_id=abc123456&medium_name=测试&time=1693811486

3、将生成后的字符串同样与 app-secret 拼接

php-demo：


                                                $app-secret = '789';

                                                $str .= "&app-secret=789";

                                                //$str = 'app_id=13000000000&medium_id=abc123456&medium_name=测试&time=1693811486&app-secret=789'

4、将字符串进行md5加密转大写，得到签名[sign]

php-demo：


                                                $sign = md5($str);

                                                $sign = strtoupper($sign);

php完整demo：


                                                /**

                                                 * 获取签名 getSign

                                                 * @param array $params 参与签名的参数

                                                 * @param sring appSecret app-secret

                                                 * @return sring 签名

                                                */

                                                private function getSign($params = [] , $appSecret)

                                                {

                                                    ksort($params);

                                                    $string = [];

                                                    foreach ($params as $key => $value) {

                                                        $string[] = $key . '=' . $value;

                                                    }

                                                    $str = implode('&', $string);

                                                    $str = $str."&app-secret=" . $appSecret;

                                                    $sign = md5($str);

                                                    return strtoupper($sign);

                                                }

公共返回

公共返回参数

参数名	类型	是否必须	描述说明
code	Integer	是	状态码
msg	String	是	返回文字信息
time	Integer	是	当前时间戳
data	data	String/Array/Object	返回的数据

状态码

状态码	含义
200	成功
401	请求方式有误
402	账号信息有误
403	请联系商务人员开通相关权限
404	签名错误
400	其它错误（详见公共返回参数“msg”参数值）

接口列表

通过开发接口创建接口

接口地址

open/createMedium

Body 请求参数

参数名	示例值	类型	是否必须	描述说明
medium_id	abc123456	String	是	达人（达人）ID：由8-13位数字或字母组成且不可重复
medium_name	测试	String	是	达人（达人）名称：至少2个字符
scene	1,2,3,4,5	String	是	推广场景，可选项 1：抖音影票，2：快手影票，3：支付宝影票，4：饿了么 - 抖音小程序，5：星选会员。多个请用“,”号隔开（需与商务对接开通对应权限）
dy_account	126586156516	String	否	抖音账号（当推广场景选择了“1：抖音影票”时，此项必填）
dy_sn	DKdg5545	String	否	抖音小程序SN码（当推广场景选择了“1：抖音影票”时，此项必填）
dy_rebate	6	Float	否	抖音影票收益比例，不得高于账号本身抖音影票总收益比例（当推广场景选择了“1：抖音影票”时，此项必填，单位：%）
ks_account	126586156516	String	否	快手账号（当推广场景选择了“1：快手影票”时，此项必填）
ks_sn	DKdg5545	String	否	快手小程序SN码（当推广场景选择了“1：快手影票”时，此项必填）
ks_rebate	6	Float	否	快手影票收益比例，不得高于账号本身快手影票总收益比例（当推广场景选择了“1：快手影票”时，此项必填，单位：%）

返回示例


                                        {

                                            "code": 200,

                                            "msg": "创建成功",

                                            "time": 1693881997,

                                            "data": ""

                                        }

通过链接自动创建

抖音及快手的影票小程序支持直接用链接跳转进来就自动创建“第三方达人ID”，这个方案对于开发而言成本较低，需要注意的是“第三方达人ID”指的是在“查询电影票票务订单”的API接口中的字段“第三方达人ID”，该字段是按您接口传过来的是什么参数我们系统就将记录什么参数的，所以这可以用于您自行判断订单的来源；

share_id=********（请参照获取方法）

1、当前的账号需要为服务商账号

2、账号内至少有一个达人账号

3、将链接绑定在一个达人账号

4、您的share_id请填写：********

custom_params=你方推广达人标识（您可以自定义传参我方只负责记录）

抖音小程序名称：钜惠影票

请联系商务人员开通相关权限
AppID：tt88c8fe7517f48dd801
首页path：pages/cinema/index/index?share_id=********&custom_params=你方推广达人标识&code=1
影片path：pages/cinema/index/details?filmid=影片ID&share_id=********&custom_params=你方推广达人标识&code=1

快手小程序名称：星选影院

请联系商务人员开通相关权限
AppID：ks689613695696519811
首页path：/pages/cinema/index/index?share_id=********&custom_params=你方推广达人标识&code=1
影片path：/pages/cinema/index/details?filmid=影片ID&share_id=********&custom_params=你方推广达人标识&code=1

信息获取工具

获取新上映影片信息

获取影票新上映影片信息的api

对接前必读

正式环境地址为：https://www.5bms.com/
请求方式：POST
入参方式： Content-Type:application/x-www-form-urlencoded
所有接口均需要签名, 详情请看[基本参数及校验]

基本参数及校验

公共 Body 请求参数

参数名	类型	是否必须	描述说明
app_id	String	是否必须	app-id
sign	String	是	签名（详见“签名规则”）
time	Integer	是	当前10位时间戳

秘钥信息

请联系商务人员开通相关权限

签名规则

1、除[sign]以外，将所有参数按照键名排序

php-demo：


                                                $params = ['app_id'=>'13000000000','sign'=>'370B282C413E6EB3C83D1A20A02AEDA0','time'=>1693811486,'medium_id' => abc123456 'medium_name' => 测试 ....];

                                                $param = ksort($param);

3、将生成后的字符串同样与 app-secret 拼接

php-demo：


                                                $app-secret = '789';

                                                $str .= "&app-secret=789";

                                                //$str = 'app_id=13000000000&medium_id=abc123456&medium_name=测试&time=1693811486&app-secret=789'

4、将字符串进行md5加密转大写，得到签名[sign]

php-demo：


                                                $sign = md5($str);

                                                $sign = strtoupper($sign);

php完整demo：


                                                /**

                                                 * 获取签名 getSign

                                                 * @param array $params 参与签名的参数

                                                 * @param sring appSecret app-secret

                                                 * @return sring 签名

                                                */

                                                private function getSign($params = [] , $appSecret)

                                                {

                                                    ksort($params);

                                                    $string = [];

                                                    foreach ($params as $key => $value) {

                                                        $string[] = $key . '=' . $value;

                                                    }

                                                    $str = implode('&', $string);

                                                    $str = $str."&app-secret=" . $appSecret;

                                                    $sign = md5($str);

                                                    return strtoupper($sign);

                                                }

公共返回

公共返回参数

参数名	类型	是否必须	描述说明
code	Integer	是	状态码
msg	String	是	返回文字信息
time	Integer	是	当前时间戳
data	data	String/Array/Object	返回的数据

状态码

状态码	含义
200	成功
401	请求方式有误
402	账号信息有误
403	请联系商务人员开通相关权限
404	签名错误
400	其它错误（详见公共返回参数“msg”参数值）

接口列表

获取新上映影片信息接口

接口地址

open/getNewFilmList

Body 请求参数

参数名	示例值	类型	是否必须	描述说明
p	1	String	否	影片列表页码数
limit	10	String	否	影片列表每页显示数

返回示例


                                        {

                                            "code": 200,

                                            "msg": "请求成功",

                                            "time": 1693881997,

                                            "data": ""

                                        }

返回参数说明

参数名	类型	描述说明
list	Array	影片列表
list.id	Integer	影片ID
list.name	String	影片名称
list.grade	String	评分
list.duration	String	时长，分钟
list.publish_date	String	影片上映日期
list.director	String	导演
list.cast	String	主演
list.intro	String	简介
list.order_amount	Float	影片金额
list.version_types	String	上映类型
list.language	String	语言
list.film_types	String	影片类型
list.pic	String	海报URL地址
list.moviearea	String	上映地区
list.actor	String	演员/导演
list.stills	String	剧照
list.is_session	Integer	是否有场次（0 、当前影片无场次，1、当前影片有场次）
page	Integer	页码
total_count	Integer	总条数
page_count	Integer	总页数
limit	Integer	每页条数

订单查询接口

查询电影票票务订单

获取电影票票务订单信息的api

建议在放映日期的次日再次过来请求订单的最终状态以确保精准度，也可以以放映日期作为条件进行查询 （如未按“放映次日再拉最终状态”导致的订单状态不准确的损失我司不承担责任）

按支付时间请求，需要传开始时间和结束时间 （建议每次查询时间范围不超过1天）

按退款时间请求，需要传开始时间和结束时间，比如1号支付的订单，在2号退款，那需要传2号的时间才能请求到 （建议每次查询时间范围不超过1天）

对接前必读

正式环境地址为：https://www.5bms.com/
请求方式：POST
入参方式： Content-Type:application/x-www-form-urlencoded
所有接口均需要签名, 详情请看[基本参数及校验]

基本参数及校验

公共 Body 请求参数

参数名	类型	是否必须	描述说明
app_id	String	是否必须	app-id
sign	String	是	签名（详见“签名规则”）
time	Integer	是	当前10位时间戳

秘钥信息

请联系商务人员开通相关权限

签名规则

1、除[sign]以外，将所有参数按照键名排序

php-demo：


                                                $params = ['app_id'=>'13000000000','sign'=>'370B282C413E6EB3C83D1A20A02AEDA0','time'=>1693811486,'medium_id' => abc123456 'medium_name' => 测试 ....];

                                                $param = ksort($param);

3、将生成后的字符串同样与 app-secret 拼接

php-demo：


                                                $app-secret = '789';

                                                $str .= "&app-secret=789";

                                                //$str = 'app_id=13000000000&medium_id=abc123456&medium_name=测试&time=1693811486&app-secret=789'

4、将字符串进行md5加密转大写，得到签名[sign]

php-demo：


                                                $sign = md5($str);

                                                $sign = strtoupper($sign);

php完整demo：


                                                /**

                                                 * 获取签名 getSign

                                                 * @param array $params 参与签名的参数

                                                 * @param sring appSecret app-secret

                                                 * @return sring 签名

                                                */

                                                private function getSign($params = [] , $appSecret)

                                                {

                                                    ksort($params);

                                                    $string = [];

                                                    foreach ($params as $key => $value) {

                                                        $string[] = $key . '=' . $value;

                                                    }

                                                    $str = implode('&', $string);

                                                    $str = $str."&app-secret=" . $appSecret;

                                                    $sign = md5($str);

                                                    return strtoupper($sign);

                                                }

公共返回

公共返回参数

参数名	类型	是否必须	描述说明
code	Integer	是	状态码
msg	String	是	返回文字信息
time	Integer	是	当前时间戳
data	data	String/Array/Object	返回的数据

状态码

状态码	含义
200	成功
401	请求方式有误
402	账号信息有误
403	请联系商务人员开通相关权限
404	签名错误
400	其它错误（详见公共返回参数“msg”参数值）

接口列表

查询电影票票务订单接口

接口地址

open/getOrderList

Body 请求参数

参数名	示例值	类型	是否必须	描述说明
status	核销成功	Integer	是	订单状态，0：全部，1：等待核销，2：核销成功，3：核销失败，4：订单失败，默认0
p	1	Integer	否	页码，默认1
limit	50	Integer	否	每页查询条数，默认50
medium_id	abc123456	String	否	达人ID
show_time	2023-08-9	Date	否	放映日期
pay_start_date	2023-08-09 11:00:00	Date	否	支付开始时间（按支付时间请求必传）
pay_end_date	2023-08-10 11:00:00	Date	否	支付结束时间（按支付时间请求必传）
refund_start_date	2023-08-09 11:00:00	Date	否	退款开始时间（按退款时间请求必传）
refund_end_date	2023-08-10 11:00:00	Date	否	退款结束时间（按退款时间请求必传）

返回示例


                                        {

                                            "code": 200,

                                            "msg": "",

                                            "time": 1693884677,

                                            "data": {

                                                "list": [

                                                {

                                                    "add_time": "2023-08-09 19:42:17",

                                                    "pay_time": "2023-08-09 19:43:17",

                                                    "refund_time": "2023-08-09 19:45:17",

                                                    "order_sn": "HB2023080957545751",

                                                    "film_name": "热烈",

                                                    "cinema_name": "英德幸福蓝海国际影城",

                                                    "order_amount": "74.28",

                                                    "order_status": "核销成功",

                                                    "commission": "4.45",

                                                    "medium_id": "13205340998"

                                                    "custom_params": "13205340998"

                                                    "nsource": "1"

                                                }

                                              ],

                                              "page": 1,

                                              "total_count": 18,

                                              "page_count": 1,

                                              "limit": 50

                                              }

                                        }

返回参数说明

参数名	类型	描述说明
list	Array	订单列表
list.add_time	String	订单创建时间
list.pay_time	String	订单支付时间
list.refund_time	String	订单退款时间
list.order_sn	String	订单编号
list.film_name	String	电影名称
list.cinema_name	String	影院名称
list.order_amount	Float	订单金额
list.order_status	String	订单状态：1、等待核销，2、核销成功，3、核销失败，4、订单失败
list.commission	Float	预估收益
list.medium_id	String	达人（达人）ID
list.custom_params	String	第三方达人ID
list.nsource	Integer	平台参数（抖音1、快手2、支付宝3、百度4）
page	Integer	页码
total_count	Integer	总条数
page_count	Integer	总页数
limit	Integer	每页条数