一、API概述
造梦电影CPS系统提供RESTful API接口，支持影院查询、场次查询、座位查询、出票等核心功能，方便开发者快速接入。
二、接入流程
- 申请API接入权限
- 获取AppID和AppSecret
- 阅读API文档
- 进行接口调试
- 正式上线
三、接口列表
| 接口名称 | 请求方式 | 功能说明 |
|---|---|---|
| /api/city/list | GET | 获取城市列表 |
| /api/cinema/list | GET | 获取影院列表 |
| /api/movie/list | GET | 获取电影列表 |
| /api/schedule/list | GET | 获取场次列表 |
| /api/seat/query | GET | 查询座位图 |
| /api/ticket/create | POST | 创建订单出票 |
四、鉴权说明
所有接口需要在Header中携带鉴权信息：
{
"Authorization": "Bearer {access_token}",
"Content-Type": "application/json"
}
五、调用示例
获取影院列表
GET /api/cinema/list?city_id=1
Response:
{
"code": 200,
"data": {
"list": [
{
"cinema_id": 1001,
"cinema_name": "万达影城(北京朝阳店)",
"address": "北京市朝阳区..."
}
]
}
}
六、错误码说明
| 错误码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 401 | 鉴权失败 |
| 403 | 权限不足 |
| 500 | 服务器错误 |
七、调用限制
- QPS限制：100次/秒
- 日调用量：无限制
- 建议使用缓存减少接口调用
八、技术支持
如有API接入问题，请联系技术支持。