<commit_before># AwesomeTickets API

<!-- MarkdownTOC -->

- [返回状态说明](#返回状态说明)
- [获取电影信息](#获取电影信息)
- [获取正在上映电影列表](#获取正在上映电影列表)
- [获取即将上映电影列表](#获取即将上映电影列表)
- [获取首页大尺寸海报](#获取首页大尺寸海报)

<!-- /MarkdownTOC -->

<a name="返回状态说明"></a>
## 返回状态说明

AwesomeTickets API 通过 HTTP Status Code 来说明 API 请求是否成功，下面的表格中展示了可能的 HTTP Status Code 以及其含义：

| Code | Content | Description |
|------|---------|-------------|
|200|OK|请求成功|
|400|BAD REQUEST|请求的地址不存在或者包含不支持的参数|
|403|FORBIDDEN|被禁止访问|
|404|NOT FOUND|请求的资源不存在|
|500|INTERNAL SERVER ERROR|内部错误|

<a name="获取电影信息"></a>
## 获取电影信息

Request URL:

```
GET /resource/movie/:id
```

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|id|电影id|int|
|title|标题|string|
|pubdate|上映日期（年/月/日）|string|
|length|时长（分钟）|int|
|rating|评分|float|
|country|制片国家|string|
|movieStatus|上映状态（正在上映->"on"，即将上映->"soon"）|string|
|movieType|类型（"2D"，"3D"，"3D IMAX"）|string|
|movieStyle|题材|string array|
|posterSmall|海报（小尺寸）URL|string|
|posterLarge|海报（大尺寸）URL|string|

Response Example:

```json
{
    "id": 1,
    "title": "美女与野兽",
    "pubdate": "2017-03-17",
    "length": 130,
    "rating": 8.2,
    "country": "美国",
    "movieStatus": "on",
    "movieType": "3D",
    "movieStyle": ["爱情", "奇幻", "歌舞"],
    "posterSmall": "http://123.123.123.123/AAA.png",
    "posterLarge": "http://123.123.123.123/BBB.png"
}
```

<a name="获取正在上映电影列表"></a>
## 获取正在上映电影列表

Request URL:

```
GET /resource/movie/on_show
```

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|count|电影数量|int|
|movies|电影 id 数组|int array|

Response Example:

```json
{
    "count": 9,
    "movies": [1, 4, 5, 8, 9, 10, 11, 15, 16]
}
```

<a name="获取即将上映电影列表"></a>
## 获取即将上映电影列表

Request URL:

```
GET /resource/movie/coming_soon
```

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|count|电影数量|int|
|movies|电影 id 数组|int array|

Response Example:

```json
{
    "count": 9,
    "movies": [2, 3, 6, 7, 12, 13, 14, 17, 18]
}
```

<a name="获取首页大尺寸海报"></a>
## 获取首页大尺寸海报

Request URL:

```
GET /resource/movie/popular?count=XXX
```

Request Parameters:

| Param | Description | Default |
|-------|-------------|---------|
|count|海报数量|3|

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|count|海报数量|int|
|subjects|（电影id，海报链接）二元组数组|array|

Response Example:

```json
{
    "count": 3,
    "subjects": [
        {
            "id": 1,
            "posterURL": "http://123.123.123.123/XXX.png"
        },
        {
            "id": 2,
            "posterURL": "http://123.123.123.123/YYY.png"
        },
        {
            "id": 3,
            "posterURL": "http://123.123.123.123/ZZZ.png"
        }
    ]
}
```<commit_msg>Update API get large poster<commit_after># AwesomeTickets API

<!-- MarkdownTOC -->

- [返回状态说明](#返回状态说明)
- [获取电影信息](#获取电影信息)
- [获取正在上映电影列表](#获取正在上映电影列表)
- [获取即将上映电影列表](#获取即将上映电影列表)
- [获取首页大尺寸海报](#获取首页大尺寸海报)

<!-- /MarkdownTOC -->

<a name="返回状态说明"></a>
## 返回状态说明

AwesomeTickets API 通过 HTTP Status Code 来说明 API 请求是否成功，下面的表格中展示了可能的 HTTP Status Code 以及其含义：

| Code | Content | Description |
|------|---------|-------------|
|200|OK|请求成功|
|400|BAD REQUEST|请求的地址不存在或者包含不支持的参数|
|403|FORBIDDEN|被禁止访问|
|404|NOT FOUND|请求的资源不存在|
|500|INTERNAL SERVER ERROR|内部错误|

<a name="获取电影信息"></a>
## 获取电影信息

Request URL:

```
GET /resource/movie/:id
```

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|id|电影id|int|
|title|标题|string|
|pubdate|上映日期（年/月/日）|string|
|length|时长（分钟）|int|
|rating|评分|float|
|country|制片国家|string|
|movieStatus|上映状态（正在上映->"on"，即将上映->"soon"）|string|
|movieType|类型（"2D"，"3D"，"3D IMAX"）|string|
|movieStyle|题材|string array|
|posterSmall|海报（小尺寸）URL|string|
|posterLarge|海报（大尺寸）URL|string|

Response Example:

```json
{
    "id": 1,
    "title": "美女与野兽",
    "pubdate": "2017-03-17",
    "length": 130,
    "rating": 8.2,
    "country": "美国",
    "movieStatus": "on",
    "movieType": "3D",
    "movieStyle": ["爱情", "奇幻", "歌舞"],
    "posterSmall": "http://123.123.123.123/AAA.png",
    "posterLarge": "http://123.123.123.123/BBB.png"
}
```

<a name="获取正在上映电影列表"></a>
## 获取正在上映电影列表

Request URL:

```
GET /resource/movie/on_show
```

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|count|电影数量|int|
|movies|电影 id 数组|int array|

Response Example:

```json
{
    "count": 9,
    "movies": [1, 4, 5, 8, 9, 10, 11, 15, 16]
}
```

<a name="获取即将上映电影列表"></a>
## 获取即将上映电影列表

Request URL:

```
GET /resource/movie/coming_soon
```

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|count|电影数量|int|
|movies|电影 id 数组|int array|

Response Example:

```json
{
    "count": 9,
    "movies": [2, 3, 6, 7, 12, 13, 14, 17, 18]
}
```

<a name="获取首页大尺寸海报"></a>
## 获取首页大尺寸海报

Request URL:

```
GET /resource/movie/popular?count=XXX
```

Request Parameters:

| Param | Description | Default |
|-------|-------------|---------|
|count|海报数量|3|

Response Properties:

| Property | Description | Type |
|----------|-------------|------|
|count|海报数量|int|
|posters|（电影id，海报链接）二元组数组|array|

Response Example:

```json
{
    "count": 3,
    "posters": [
        {
            "id": 1,
            "uri": "http://123.123.123.123/XXX.png"
        },
        {
            "id": 2,
            "uri": "http://123.123.123.123/YYY.png"
        },
        {
            "id": 3,
            "uri": "http://123.123.123.123/ZZZ.png"
        }
    ]
}
```
{'fraction_non_alphanumeric': 0.26248632883703976, 'fraction_numerical': 0.04629967189208895, 'mean_word_length': 2.709939148073022, 'pattern_counts': {'":': 46, '<': 27, '<?xml version=': 0, '>': 31, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 10, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6974389', 'n_tokens_mistral': 2797, 'n_tokens_neox': 2832, 'n_words': 388}