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

BlackBird·2024년 10월 31일

Team Project

목록 보기
40/66

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개 밖에 없다니..

그래도 뿌듯은 하네.

profile
한영신의 벨로그입니다.

0개의 댓글