Coding History/Team Project

팀플) Star Info API 요청 방식 설명.

BlackBirdIT 2024. 10. 31. 16:03

1. /api/constellations (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • lat (필수, float): 위도
    • lon (필수, float): 경도
    • start_date (선택, str, YYYY-MM-DD): 시작 날짜
    • end_date (선택, str, YYYY-MM-DD): 종료 날짜
  • 설명: 사용자가 요청한 위도, 경도, 날짜 범위에 따라 해당 위치에서 관측할 수 있는 별자리 정보를 반환한다. 별자리의 가시성도 함께 계산함.

2. /api/sunrise_sunset (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • lat (필수, float): 위도
    • lon (필수, float): 경도
    • start_date (선택, str, YYYY-MM-DD): 시작 날짜
    • end_date (선택, str, YYYY-MM-DD): 종료 날짜
  • 설명: 요청한 위치에서 지정된 날짜 범위 동안의 일출 및 일몰 시간을 반환한다.

3. /api/planet_visibility (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • planet (필수, str): 행성 이름
    • lat (필수, float): 위도
    • lon (필수, float): 경도
    • date (필수, str, YYYY-MM-DD): 날짜
    • range_days (선택, int): 조회 기간 (기본값 1일)
  • 설명: 요청한 위치와 날짜 범위 동안 특정 행성의 가시성 정보를 반환한다.

4. /api/opposition (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • planet (필수, str): 행성 이름
    • year (필수, int): 조회할 연도
  • 설명: 요청한 행성의 대접근 이벤트 예측 정보를 반환한다.

5. /api/update_raw_data (POST)

  • 요청 방식: POST
  • 설명: 행성 대접근 이벤트 데이터를 업데이트한다. 업데이트 과정은 비동기적으로 진행됨.

6. /api/comet_approach (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • comet (필수, str): 혜성 이름
    • start_date (필수, str, YYYY-MM-DD): 시작 날짜
    • range_days (선택, int, 기본값 365): 조회할 기간
    • latitude (선택, float): 위도
    • longitude (선택, float): 경도
  • 설명: 요청한 혜성의 접근 이벤트 정보를 반환한다.

7. /api/meteor_shower (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • comet (필수, str): 혜성 이름
    • start_date (필수, str, YYYY-MM-DD): 시작 날짜
    • range_days (선택, int, 기본값 365): 조회할 기간
  • 설명: 혜성의 접근 이벤트를 바탕으로 유성우 정보를 반환한다.

8. /api/update_meteor/raw_data (POST)

  • 요청 방식: POST
  • 설명: 유성우 데이터를 업데이트한다.

9. /api/meteor_shower_visibility (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • name (필수, str): 유성우 이름
    • year (필수, int): 조회할 연도
    • latitude (필수, float): 관측자의 위도
    • longitude (필수, float): 관측자의 경도
  • 설명: 요청한 유성우의 이름, 연도, 위치를 바탕으로 유성우 가시성을 평가한다.

10. /api/moon_phase (GET)

  • 요청 방식: GET
  • 필요한 파라미터:
    • latitude (선택, float): 위도
    • longitude (선택, float): 경도
    • date (필수, str, YYYY-MM-DD): 날짜
  • 설명: 특정 날짜와 위치에 대한 달의 위상을 계산하여 반환한다.

정말 별로 어렵지 않을거라고 생각하고 시작한건데 뭔가 많이 했다는 생각과 달리 요청 방식이 10개 밖에 없다니..

그래도 뿌듯은 하네.