# Movies/Theaters API ## Get Movie List `GET` `https://younghoonjean.com/api/movies/` 전체 영화목록을 보여줍니다. #### Query Parameters | Name | Type | Description | | ---- | ------- | ---------------- | | page | integer | need page number | {% tabs %} {% tab title="200 Cake successfully retrieved." %} ```javascript ``` {% endtab %} {% endtabs %} ## Get Movie Detail `GET` `https://younghoonjean.com/api/movies/detail//` 특정 영화의 pk를 전달하면 영화 상세정보를 전달합니다. #### Path Parameters | Name | Type | Description | | -------- | ------- | ------------ | | movie pk | integer | get movie pk | {% tabs %} {% tab title="200 " %} ```javascript { "pk": 2, # 영화 타이틀 "title": "보헤미안 랩소디", # 영화 감독 "director": "브라이언 싱어", # 영화 배우 "casts": [ { "actor": "레미 맬렉 " }, { "actor": " 루시 보인턴 " }, { "actor": " 귈림 리 " }, { "actor": " 벤 하디 " }, { "actor": " 조셉 마젤로" } ], # 러닝타 "durationMin": 134, # 개봉 "openingDate": "2018-10-31", #장르 "genre": " 드라마", # 줄거 "description": "“나는 스타가 되지 않을 것이다, 전설이 될 것이다”

공항에서 수하물 노동자로 일하며 음악의 꿈을 키우던 이민자 출신의 아웃사이더 ‘파록버사라’
보컬을 구하던 로컬 밴드에 들어가게 되면서 ‘프레디 머큐리’라는 이름으로 밴드 ‘퀸’을 이끌게 된다.

시대를 앞서가는 독창적인 음악과 화려한 퍼포먼스로 관중들을 사로잡으며 성장하던 ‘퀸’은
라디오와 방송에서 외면을 받을 것이라는 음반사의 반대에도 불구하고
무려 6분 동안 이어지는 실험적인 곡 ‘보헤미안 랩소디’로 대성공을 거두며 월드스타 반열에 오른다.

그러나 독보적인 존재감을 뿜어내던 ‘프레디 머큐리’는 솔로 데뷔라는 유혹에 흔들리게 되고
결국 오랜 시간 함께 해왔던 멤버들과 결별을 선언하게 되는데…

세상에서 소외된 아웃사이더에서 전설의 록밴드 ‘퀸’이 되기까지,
우리가 몰랐던 그들의 진짜 이야기가 시작된다!", # 트레일 "trailer": "", # 예매 "reservationScore": 0, # 현재 상영 여 "nowShow": false, # 메인 포스 "mainImgUrl": "http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_ZyvzeYw.jpeg", # 스틸 "stillcuts": [ { "imageUrl": "http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_1.jpeg" }, { "imageUrl": "http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_2.jpeg" }, { "imageUrl": "http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_3.jpeg" }, { "imageUrl": "http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_4.jpeg" }, { "imageUrl": "http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_5.jpeg" } ] } ``` {% endtab %} {% endtabs %} ## Get Theater List `GET` `https://younghoonjean.com/api/theaters/` 전국 영화관 리스를 return합니다. #### Query Parameters | Name | Type | Description | | -------- | ------ | --------------------------------------------- | | location | string | show theaters which belongs to input location | {% tabs %} {% tab title="200 " %} ```javascript [ { "pk":4, # 주소1 "location":"강원", # 주소2 ( = 영화관 이름) "sub_location":"원주" }, {"pk":3,"location":"서울","sub_location":"신촌"}, {"pk":2,"location":"서울","sub_location":"강남"} ] ``` {% endtab %} {% endtabs %} ## Get Theater Detail `GET` `https://younghoonjean.com/api/theaters/detail//` 영화관 pk를 전달하면 해당 영화관의 상세정보(영화관 정보/상영관 정보/상영 영화정보)를 전달합니다. #### Path Parameters | Name | Type | Description | | ---------- | ------- | ----------------------- | | theater pk | integer | get theater instance pk | {% tabs %} {% tab title="200 " %} ```javascript { "location":"서울", "sub_location":"강남", "address":"서울특별시 강남구 역삼동 814-6 스타플렉스", "current_movies": # 해당 극장에 상영 중인 영화 리스 [ { "title":"보헤미안 랩소디", "now_show":false, "genre":" 드라마", "duration_min":134, "opening_date":"2018-10-31", "main_img_url":"http://localhost:8000/media/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88%20%EB%9E%A9%EC%86%8C%EB%94%94/%EB%B3%B4%ED%97%A4%EB%AF%B8%EC%95%88_%EB%9E%A9%EC%86%8C%EB%94%94_pqavIPp.jpeg" }, { "title":"모털 엔진", "now_show":false, "genre":" 액션, SF, 어드벤처", "duration_min":128, "opening_date":"2018-12-05", "main_img_url":"http://localhost:8000/media/%EB%AA%A8%ED%84%B8%20%EC%97%94%EC%A7%84/%EB%AA%A8%ED%84%B8_%EC%97%94%EC%A7%84_pPS865c.jpeg" }, { "title":"런닝맨-풀룰루의 역습", "now_show":false, "genre":" 애니메이션", "duration_min":67,"opening_date":"2018-12-05", "main_img_url":"http://localhost:8000/media/%EB%9F%B0%EB%8B%9D%EB%A7%A8-%ED%92%80%EB%A3%B0%EB%A3%A8%EC%9D%98%20%EC%97%AD%EC%8A%B5/%EB%9F%B0%EB%8B%9D%EB%A7%A8-%ED%92%80%EB%A3%B0%EB%A3%A8%EC%9D%98_%EC%97%AD%EC%8A%B5_VjChfWP.jpeg" } ], "all_auditoriums_no":3, # 극장 총 상영관 "all_seats_no":300, # 극장 총 좌석 수 "screenings": # 상영 리스 [ { "auditorium": # 해당 상영관 이름/총 좌석수/영화 상영 스케 { "name":"3관", "seats_no":100}, "screening_times": # 영화 상영 시간/남은 좌석 수(총 좌석수 - 예약된 좌석 수) [ { "time":"2018-12-05T13:12:58+09:00", "current_seats_no":100 }, { "time":"2018-12-08T13:13:01+09:00", "current_seats_no":100 } ] }, ] } ``` {% endtab %} {% endtabs %} ## Get pre-movie `GET` `https://younghoonjean.com/api/movies/pre/` 상영 예정 영화들을 전달합니다. (영화 pk, 제목, 예매율, 메인포스터, 개봉여부, 개봉일 )
#### Query Parameters | Name | Type | Description | | ---- | ------- | ---------------- | | page | integer | need page number | {% tabs %} {% tab title="200 " %} ``` [ { "pk": 2, "title": "스윙키즈", "reservationScore": 0, "mainImgUrl": "https://wps-9th-practice1.s3.amazonaws.com/media/%EC%8A%A4%EC%9C%99%ED%82%A4%EC%A6%88/%EC%8A%A4%EC%9C%99%ED%82%A4%EC%A6%88.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJUQTVUBEK4SPUPKA%2F20181213%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181213T060627Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=e7fa964261b9135e8af73e85a81bf000627e56e03755c58f9f19f2c32895501f", "nowShow": false, "openingDate": "2018-12-19" }, ... ] ``` {% endtab %} {% endtabs %} ## Get Movie staff List `GET` `https://younghoonjean.com/api/movies/staff//` 해당하는 영화( Movie PK) 가 들어오게 되면 , 영화의 감독과 배우들의 이름, 영문 이름, 이미지를 반환합니다. #### Path Parameters | Name | Type | Description | | ------------- | ------- | --------------------- | | movie pk | integer | get movie instance pk | | Authorization | string | Token \ | {% tabs %} {% tab title="200 " %} ``` { "directors": [ { "director": "밥 퍼시케티", "engDirector": "", "profileImg": "https://wps-9th-practice1.s3.amazonaws.com/media/%EB%B0%A5%20%ED%8D%BC%EC%8B%9C%EC%BC%80%ED%8B%B0/%EC%8A%A4%ED%8C%8C%EC%9D%B4%EB%8D%94%EB%A7%A8-%EB%89%B4_%EC%9C%A0%EB%8B%88%EB%B2%84%EC%8A%A4.gif?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJUQTVUBEK4SPUPKA%2F20181217%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181217T122453Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=4d38a37447f66295a56e31984295173b8172c35d8d61d68831f6eb1443616e76" } ], "casts": [ { "actor": "샤메익 무어", "engActor": "Shameik Moore", "profileImgUrl": "https://wps-9th-practice1.s3.amazonaws.com/media/%EC%83%A4%EB%A9%94%EC%9D%B5%20%EB%AC%B4%EC%96%B4/%EC%8A%A4%ED%8C%8C%EC%9D%B4%EB%8D%94%EB%A7%A8-%EB%89%B4_%EC%9C%A0%EB%8B%88%EB%B2%84%EC%8A%A4.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJUQTVUBEK4SPUPKA%2F20181217%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181217T122453Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=3feab055e90e7a2fb45df1a2a9f195970b996833a4cf5c8fa71161bf934854d6" }, { "actor": "헤일리 스테인펠드", "engActor": "Hailee Steinfeld", "profileImgUrl": "https://wps-9th-practice1.s3.amazonaws.com/media/%ED%97%A4%EC%9D%BC%EB%A6%AC%20%EC%8A%A4%ED%85%8C%EC%9D%B8%ED%8E%A0%EB%93%9C/%EC%8A%A4%ED%8C%8C%EC%9D%B4%EB%8D%94%EB%A7%A8-%EB%89%B4_%EC%9C%A0%EB%8B%88%EB%B2%84%EC%8A%A4.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJUQTVUBEK4SPUPKA%2F20181217%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181217T122453Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=f7a912fa99f0dfb264212cb6f6aa2e45fb6c6ba0d22475bb703ba313f4047645" }, { "actor": "니콜라스 케이지", "engActor": "Nicolas Cage", "profileImgUrl": "https://wps-9th-practice1.s3.amazonaws.com/media/%EB%8B%88%EC%BD%9C%EB%9D%BC%EC%8A%A4%20%EC%BC%80%EC%9D%B4%EC%A7%80/%EC%8A%A4%ED%8C%8C%EC%9D%B4%EB%8D%94%EB%A7%A8-%EB%89%B4_%EC%9C%A0%EB%8B%88%EB%B2%84%EC%8A%A4.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJUQTVUBEK4SPUPKA%2F20181217%2Fap-northeast-2%2Fs3%2Faws4_request&X-Amz-Date=20181217T122453Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=2943268c0739783a417726711be518812b26039b02be758a5d9493c352842552" }, .... ] } ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://cgvproject.gitbook.io/cgvproject/movies-theaters-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.