{"openapi":"3.0.0","info":{"version":"0.0.1","title":"42mogle-api-example","description":"42mogle 웹 어플리케이션 API example 입니다. 테스트, 연습 겸 작게 만들었습니다. 요런 느낌으로 API 명세서 만들 것 같습니다! [jsonplaceholder 사이트](https://jsonplaceholder.typicode.com/) 에서 API를 통해 JSON을 주고 받는 방법을 알 수 있습니다! 밑에 작은 테스트 API를 만들었으니 API 사용에 익숙하지 않으시다면 한 번 써보세요!"},"servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/WLGUQ100/42mogle-example/0.0.1"},{"url":"10.19.213.129:3000"},{"url":"https://jsonplaceholder.typicode.com/"}],"tags":[{"name":"user","description":"Everything about Users","externalDocs":{"description":"Find out more","url":"http://swagger.io"}}],"paths":{"/user":{"get":{"tags":["user"],"summary":"모든 유저 정보","operationId":"getAllUsers","responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"400":{"description":"Invalid intraId supplied"},"404":{"description":"User not found"}}},"post":{"tags":["user"],"summary":"사용자 등록 (Add a new user)","operationId":"addUser","responses":{"405":{"description":"Invalid input"}},"requestBody":{"$ref":"#/components/requestBodies/RegisterUser"}}},"/user/{intraId}":{"get":{"tags":["user"],"summary":"인트라 아이디로 유저 찾기 (Get user by intra id)","operationId":"getUserByIntraId","parameters":[{"name":"intraId","in":"path","description":"intra ID of user that needs to be fetched.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"400":{"description":"Invalid intraId supplied"},"404":{"description":"User not found"}}}},"/todos/{id}":{"get":{"tags":["test"],"summary":"json place holder site에 저장된 todos에서 특정 id에 대한 todo를 얻을 수 있음","operationId":"getTodosById","parameters":[{"name":"id","in":"path","description":"위에 Servers의 주소를 https://jsonplaceholder.typicode.com/ 사이트로 설정하고 id 값을 1,3,5 ... 등 원하는 값을 넣고 테스트해보세요. 나중에 우리 서버에서도 어떤 방식으로 json을 확인하는지 수월하게 파악할 수 있습니당.","required":true,"schema":{"type":"integer","format":"int64","minimum":1,"maximum":200}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"integer"},"id":{"type":"integer"},"title":{"type":"string"},"completed":{"type":"boolean"}}}}}}}}}},"components":{"schemas":{"User":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"intraId":{"type":"string"},"attendanceStatus":{"type":"integer","format":"int32","description":"User Status"}}},"RegisterUser":{"type":"object","properties":{"intraId":{"type":"string"},"email":{"type":"string"},"password":{"type":"string"}}}},"requestBodies":{"RegisterUser":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterUser"}}},"description":"User object that needs to be added to the user database","required":true}}}}