IMDB Backend
数据库课设 —— IMDB 查找系统（后端仓库）
- IMDB Backend
Source Database SQL File
The data source is IMDb and all the data in the SQL file is up to 2018.06.01 .
Here is the SQL file link: https://pan.baidu.com/s/1WcZZB7j-nbMRhp4MwZhRXA
Password：h3zj
Attention: If your machine has enough memory (>= 4 GiB), you should use the imdb_2018_06_01_extended_insert.sql file to increase the import speed. Otherwise, use imdb_2018_06_01.sql file in case of OOM (Out of Memory) .
Database Migration
Recommand procedure:
# Before the migration
sql> SET autocommit = 0;
sql> SET unique_checks = 0;
sql> SET foreign_key_checks = 0;
# Start the migration
sql> CREATE DATABASE imdb;
sql> USE imdb;
sql> SOURCE your_sql_file.sql;
# After the migration
sql> COMMIT;
sql> SET unique_checks = 1;
sql> SET foreign_key_checks = 1;Or:
$ cat default-start-import.sql your_sql_file.sql default-end-import.sql | mysql -h db_address -P db_port -uroot -p your_db_namefrom the command line.
Turn off
extended-insertwhen you dumping your database, or it will be easily OOM(Out Of Memory) in the importing procedure.
General Settings
All settings in app/settings.go .
Including database settings.
API References
API root: http://localhost:2333/api/v1
Search
Fuzzy search titles
GET /api/v1/search/titles
Parameters
| Name | Type | Description |
|---|---|---|
q |
string |
待搜索字段 |
page |
int |
当前请求的页号 |
若缺少
page字段，则默认返回第一页的信息。
Response
Status: 200 OK
{
"count": 20,
"cur_page": 1,
"data": [
{
"Id": {
"Int64": 69495,
"Valid": true
},
"TConst": {
"String": "tt0070909",
"Valid": true
},
"TitleType": {
"String": "movie",
"Valid": true
},
"PrimaryTitle": {
"String": "Westworld",
"Valid": true
},
"OriginalTitle": {
"String": "Westworld",
"Valid": true
},
"IsAdult": {
"Bool": false,
"Valid": true
},
"StartYear": {
"Int64": 1973,
"Valid": true
},
"EndYear": {
"Int64": 0,
"Valid": false
},
"RuntimeMinutes": {
"Int64": 88,
"Valid": true
},
"Genres": {
"String": "Action,Sci-Fi,Thriller",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T22:14:51Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T22:14:51Z",
"Valid": true
}
}
],
"next_page": 2,
"prev_page": -1,
"server_time": "2018-06-13T23:34:27.568742891+08:00",
"start_id": 0,
"total_page": 3
}Fuzzy search names
GET /api/v1/search/names
Parameters
| Name | Type | Description |
|---|---|---|
q |
string |
待搜索字段 |
page |
int |
当前请求的页号 |
若缺少
page字段，则默认返回第一页的信息。
Response
Status: 200 OK
{
"count": 50,
"cur_page": 1,
"data": [
{
"Id": {
"Int64": 600811,
"Valid": true
},
"NConst": {
"String": "nm0634240",
"Valid": true
},
"PrimaryName": {
"String": "Christopher Nolan",
"Valid": true
},
"BirthYear": {
"Int64": 1970,
"Valid": true
},
"DeathYear": {
"Int64": 0,
"Valid": false
},
"PrimaryProfession": {
"String": "writer,producer,director",
"Valid": true
},
"KnownForTitles": {
"String": "tt0482571,tt1375666,tt0816692,tt0154506",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
}
}
],
"next_page": 2,
"prev_page": -1,
"server_time": "2018-06-13T23:38:58.420526838+08:00",
"start_id": 0,
"total_page": 14
}Advanced search titles
GET /api/v1/advanced_search/titles
Parameters
| Name | Type | Description |
|---|---|---|
q |
string |
待搜索字段（支持布尔表达式） |
tconst |
string |
影片唯一标识号 |
isAdult |
string |
成人分类标识 |
startYearStart |
int |
影片/电视剧开始年份的起始值 |
startYearEnd |
int |
影片/电视剧开始年份的结束值 |
endYearStart |
int |
电视剧结束年份的起始值 |
endYearEnd |
int |
电视剧结束年份的结束值 |
runtimeMinStart |
int |
影片持续时间的起始值 |
runtimeMinEnd |
int |
影片持续时间的结束值 |
page |
int |
当前请求的页号 |
以上值都为非必需，若值为空可以不传。
Response
Status: 200 OK
{
"count": 1,
"cur_page": 1,
"data": [
{
"Id": {
"Int64": 458041,
"Valid": true
},
"TConst": {
"String": "tt0475784",
"Valid": true
},
"TitleType": {
"String": "tvSeries",
"Valid": true
},
"PrimaryTitle": {
"String": "Westworld",
"Valid": true
},
"OriginalTitle": {
"String": "Westworld",
"Valid": true
},
"IsAdult": {
"Bool": false,
"Valid": true
},
"StartYear": {
"Int64": 2016,
"Valid": true
},
"EndYear": {
"Int64": 0,
"Valid": false
},
"RuntimeMinutes": {
"Int64": 62,
"Valid": true
},
"Genres": {
"String": "Drama,Mystery,Sci-Fi",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T22:14:51Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T22:14:51Z",
"Valid": true
}
}
],
"next_page": -1,
"prev_page": -1,
"server_time": "2018-06-16T15:46:04.38158079+08:00",
"start_id": 0,
"total_page": 1
}Advanced search names
GET /api/v1/advanced_search/names
Parameters
| Name | Type | Description |
|---|---|---|
q |
string |
待搜索字段（支持布尔表达式） |
nconst |
string |
人物唯一标识号 |
birthYearStart |
int |
人物出生年的起始值 |
birthYearEnd |
int |
人物出生年的结束值 |
deathYearStart |
int |
人物去世年的起始值 |
deathYearEnd |
int |
人物去世年的结束值 |
page |
int |
当前请求的页号 |
以上值都为非必需，若值为空可以不传。
Response
Status: 200 OK
{
"count": 50,
"cur_page": 1,
"data": [
{
"Id": {
"Int64": 887972,
"Valid": true
},
"NConst": {
"String": "nm0939697",
"Valid": true
},
"PrimaryName": {
"String": "Evan Rachel Wood",
"Valid": true
},
"BirthYear": {
"Int64": 1987,
"Valid": true
},
"DeathYear": {
"Int64": 0,
"Valid": false
},
"PrimaryProfession": {
"String": "actress,soundtrack,music_department",
"Valid": true
},
"KnownForTitles": {
"String": "tt0328538,tt1178663,tt1124035,tt0475784",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
}
}
],
"next_page": 2,
"prev_page": -1,
"server_time": "2018-06-16T15:55:51.299654741+08:00",
"start_id": 0,
"total_page": 3
}Titles
List titles
GET /api/v1/titles
Parameters
| Name | Type | Description |
|---|---|---|
page |
int |
当前请求的页号 |
若缺少该字段，则默认返回第一页的信息。
Response
Status: 200 OK
{
"count": 20,
"cur_page": 1,
"data": [
{
"Id": {
"Int64": 1,
"Valid": true
},
"TConst": {
"String": "tt0000001",
"Valid": true
},
"TitleType": {
"String": "short",
"Valid": true
},
"PrimaryTitle": {
"String": "Carmencita",
"Valid": true
},
"OriginalTitle": {
"String": "Carmencita",
"Valid": true
},
"IsAdult": {
"Bool": false,
"Valid": true
},
"StartYear": {
"Int64": 1894,
"Valid": true
},
"EndYear": {
"Int64": 0,
"Valid": false
},
"RuntimeMinutes": {
"Int64": 1,
"Valid": true
},
"Genres": {
"String": "Documentary,Short",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T00:34:03Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T00:34:03Z",
"Valid": true
}
}
],
"next_page": 2,
"prev_page": -1,
"server_time": "2018-06-12T20:36:20.989811937+08:00",
"start_id": 0,
"total_page": 251881
}若页号为
-1，代表该页不可用。
Get a title
GET /api/v1/titles/:id
GET /api/v1/titles/:tconst
同时支持
id和tconst值获取，得到的结果相同。只有
Get a title和Get a name支持双值获取，为了方便查询结果。其他 API 还是需要唯一id号才可操作。
Response
Status: 200 OK
{
"data": {
"Id": {
"Int64": 1,
"Valid": true
},
"TConst": {
"String": "tt0000001",
"Valid": true
},
"TitleType": {
"String": "short",
"Valid": true
},
"PrimaryTitle": {
"String": "Carmencita",
"Valid": true
},
"OriginalTitle": {
"String": "Carmencita",
"Valid": true
},
"IsAdult": {
"Bool": false,
"Valid": true
},
"StartYear": {
"Int64": 1894,
"Valid": true
},
"EndYear": {
"Int64": 0,
"Valid": false
},
"RuntimeMinutes": {
"Int64": 1,
"Valid": true
},
"Genres": {
"String": "Documentary,Short",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T00:34:03Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T00:34:03Z",
"Valid": true
}
},
"server_time": "2018-06-12T20:41:17.100390307+08:00"
}Create a title
POST /api/v1/titles
Parameters
| Name | Type | Description |
|---|---|---|
tconst |
string |
必填. 影片唯一标识号 |
title_type |
string |
必填. 影片类型 |
primary_title |
string |
必填. 影片英文名称 |
original_title |
string |
影片源名称 |
is_adult |
bool |
必填. 成人分类标识 |
start_year |
int |
影片/电视剧开始年份 |
end_year |
int |
电视剧结束年份 |
runtime_minutes |
int |
影片持续时间 |
genres |
string |
影片分类（最多三个） |
form-data和application/json都能被接受，且字段名称类型相同。
Response
Status: 200 OK
{
"insert_id": 5037605,
"server_time": "2018-06-12T20:57:10.172114944+08:00"
}Update a title
PUT /api/v1/titles/:id
Parameters
| Name | Type | Description |
|---|---|---|
tconst |
string |
必填. 影片唯一标识号 |
title_type |
string |
必填. 影片类型 |
primary_title |
string |
必填. 影片英文名称 |
original_title |
string |
影片源名称 |
is_adult |
bool |
必填. 成人分类标识 |
start_year |
int |
影片/电视剧开始年份 |
end_year |
int |
电视剧结束年份 |
runtime_minutes |
int |
影片持续时间 |
genres |
string |
影片分类（最多三个） |
form-data和application/json都能被接受，且字段名称类型相同。
Response
Status: 200 OK
{
"server_time": "2018-06-12T20:58:21.282769281+08:00",
"updated_id": "5037605"
}Delete a title
DELETE /api/v1/titles/:id
Response
Status: 204 No Content
Get a title details
GET /api/v1/titles/:id/details
Response
Status: 200 OK
{
"count": 10,
"data": [
{
"Id": {
"Int64": 3295656,
"Valid": true
},
"TitleId": {
"Int64": 458041,
"Valid": true
},
"TConst": {
"String": "tt0475784",
"Valid": true
},
"Ordering": {
"Int64": 1,
"Valid": true
},
"NameId": {
"Int64": 1379242,
"Valid": true
},
"PrimaryName": {
"String": "Evan Rachel Wood",
"Valid": true
},
"Category": {
"String": "actress",
"Valid": true
},
"Job": {
"String": "",
"Valid": false
},
"Characters": {
"String": "Dolores Abernathy",
"Valid": true
}
}
],
"server_time": "2018-06-16T14:58:01.641212628+08:00"
}Names
List names
GET /api/v1/names
Parameters
| Name | Type | Description |
|---|---|---|
page |
int |
当前请求的页号 |
若缺少该字段，则默认返回第一页的信息。
Response
Status: 200 OK
{
"count": 50,
"cur_page": 1,
"data": [
{
"Id": {
"Int64": 1,
"Valid": true
},
"NConst": {
"String": "nm0000001",
"Valid": true
},
"PrimaryName": {
"String": "Fred Astaire",
"Valid": true
},
"BirthYear": {
"Int64": 1899,
"Valid": true
},
"DeathYear": {
"Int64": 1987,
"Valid": true
},
"PrimaryProfession": {
"String": "soundtrack,actor,miscellaneous",
"Valid": true
},
"KnownForTitles": {
"String": "tt0050419,tt0072308,tt0043044,tt0045537",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
}
}
],
"next_page": 2,
"prev_page": -1,
"server_time": "2018-06-12T23:48:53.499463315+08:00",
"start_id": 0,
"total_page": 172809
}若页号为
-1，代表该页不可用。
Get a name
GET /api/v1/names/:id
GET /api/v1/names/:nconst
同时支持
id和nconst值获取，得到的结果相同。只有
Get a name和Get a title支持双值获取，为了方便查询结果。其他 API 还是需要唯一id号才可操作。
Response
Status: 200 OK
{
"data": {
"Id": {
"Int64": 1,
"Valid": true
},
"NConst": {
"String": "nm0000001",
"Valid": true
},
"PrimaryName": {
"String": "Fred Astaire",
"Valid": true
},
"BirthYear": {
"Int64": 1899,
"Valid": true
},
"DeathYear": {
"Int64": 1987,
"Valid": true
},
"PrimaryProfession": {
"String": "soundtrack,actor,miscellaneous",
"Valid": true
},
"KnownForTitles": {
"String": "tt0050419,tt0072308,tt0043044,tt0045537",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-12T23:01:04Z",
"Valid": true
}
},
"server_time": "2018-06-12T23:50:59.574007901+08:00"
}Create a name
POST /api/v1/names
Parameters
| Name | Type | Description |
|---|---|---|
nconst |
string |
必填. 人物唯一标识号 |
primary_name |
string |
必填. 姓名 |
birth_year |
int |
出生年 |
death_year |
int |
去世年 |
primary_profession |
string |
人物主要领域/技能 |
known_for_titles |
string |
知名作品（按影片唯一标识号填写） |
form-data和application/json都能被接受，且字段名称类型相同。
Response
Status: 200 OK
{
"insert_id": 8650621,
"server_time": "2018-06-12T23:57:15.220742086+08:00"
}Update a name
PUT /api/v1/names/:id
Parameters
| Name | Type | Description |
|---|---|---|
nconst |
string |
必填. 人物唯一标识号 |
primary_name |
string |
必填. 姓名 |
birth_year |
int |
出生年 |
death_year |
int |
去世年 |
primary_profession |
string |
人物主要领域/技能 |
known_for_titles |
string |
知名作品（按影片唯一标识号填写） |
form-data和application/json都能被接受，且字段名称类型相同。
Response
Status: 200 OK
{
"server_time": "2018-06-12T23:57:53.108846482+08:00",
"updated_id": "8650621"
}Delete a name
DELETE /api/v1/names/:id
Response
Status: 204 No Content
Principals
Get a principal
GET /api/v1/principals/:id
Response
Status: 200 OK
{
"data": {
"Id": {
"Int64": 3295656,
"Valid": true
},
"TConst": {
"String": "tt0475784",
"Valid": true
},
"Ordering": {
"Int64": 1,
"Valid": true
},
"NConst": {
"String": "nm0939697",
"Valid": true
},
"Category": {
"String": "actress",
"Valid": true
},
"Job": {
"String": "",
"Valid": false
},
"Characters": {
"String": "Dolores Abernathy",
"Valid": true
},
"CreateDate": {
"Time": "2018-06-14T21:24:15Z",
"Valid": true
},
"LastUpdated": {
"Time": "2018-06-14T21:24:15Z",
"Valid": true
}
},
"server_time": "2018-06-16T15:06:06.861335428+08:00"
}Create a principal
POST /api/v1/principals
Parameters
| Name | Type | Description |
|---|---|---|
tconst |
string |
必填. 影片唯一标识号 |
ordering |
int |
必填. 人物在影片中的排序 |
nconst |
string |
必填. 人物唯一标识号 |
category |
string |
人物主要职务 |
job |
string |
人物主要职责 |
characters |
string |
人物扮演的角色名 |
form-data和application/json都能被接受，且字段名称类型相同。
Response
Status: 200 OK
{
"insert_id": 28507726,
"server_time": "2018-06-16T15:17:36.334594154+08:00"
}Update a principal
PUT /api/v1/principals/:id
Parameters
| Name | Type | Description |
|---|---|---|
tconst |
string |
必填. 影片唯一标识号 |
ordering |
int |
必填. 人物在影片中的排序 |
nconst |
string |
必填. 人物唯一标识号 |
category |
string |
人物主要职务 |
job |
string |
人物主要职责 |
characters |
string |
人物扮演的角色名 |
form-data和application/json都能被接受，且字段名称类型相同。
Response
Status: 200 OK
{
"server_time": "2018-06-16T15:20:03.23159969+08:00",
"updated_id": "28507726"
}Delete a principal
DELETE /api/v1/principals/:id
Response
Status: 204 No Content
Copyright
This project is licensed under BSD 3-Clause license.
Copyright © 2018 Zhenzhen Zhao