OpenAPI

Tables (8)

tb_api_credential

  • cred_id — BIGINT — Primary key — NOT NULL — 인증키 ID (PK)
  • cred_nm — VARCHAR(100) — NOT NULL — 인증키 구분 이름 (예: 수온조회 승인키)
  • secret_key — VARCHAR(1000) — NOT NULL — 암호화된 API 키 문자열
  • user_account — VARCHAR(100) — 발급 계정/이메일
  • expires_at — DATE — 해당 승인/키의 유효기간 만료일
  • created_at — TIMESTAMP WITH TIME ZONE — NOT NULL
  • updated_at — TIMESTAMP WITH TIME ZONE — NOT NULL

tb_api_credential_mapper

  • mapper_id — BIGINT — Primary key — NOT NULL — 매핑 ID(PK)
  • cred_id — BIGINT — Foreign key → tb_api_credential.cred_id — NOT NULL — 인증키 ID (PK)
  • api_id — BIGINT — Foreign key → tb_api_service.api_id — 서비스 ID (PK)
  • op_id — BIGINT — Foreign key → tb_api_operation.op_id — NOT NULL — 기능 ID (PK)

tb_api_job

  • job_id — BIGINT — Primary key — NOT NULL — 작업 ID(PK)
  • op_id — BIGINT — Foreign key → tb_api_operation.op_id — NOT NULL — 기능 ID (PK)
  • cred_id — BIGINT — Foreign key → tb_api_credential.cred_id — 인증키 ID (PK)
  • target_id — BIGINT — Foreign key → tb_collection_target.target_id — 저장 대상 ID(PK)
  • job_nm — VARCHAR(200) — NOT NULL — 수집 작업 이름
  • job_desc — TEXT — 수집 작업 설명
  • execution_type — VARCHAR(20) — NOT NULL — 실행 타입(COLLECT, CALL_ONLY)
  • parameter_config — JSONB — 동적 값 생성 규칙
  • storage_config — JSONB — 응답 필드와 Taeget 컬럼 매핑, 변환방식 규칙
  • execution_config — JSONB — 재시도, 페이징 등 실행 규칙
  • job_stat — VARCHAR(20) — NOT NULL — 작업 상태
  • created_at — TIMESTAMPTZ — NOT NULL
  • updated_at — TIMESTAMPTZ — NOT NULL

tb_api_job_schedule

  • schedule_id — BIGINT — Primary key — NOT NULL — 스케줄 ID(PK)
  • job_id — BIGINT — Foreign key → tb_api_job.job_id — NOT NULL — 작업 ID(PK)
  • schedule_type — VARCHAR(20) — NOT NULL — 스케줄 방식
  • cron_expression — VARCHAR(100) — (CRON) 표현식
  • interval_value — INTEGER — (INTERVAL) 실행 간격
  • interval_unit — VARCHAR(20) — (INTERVAL) 반복 단위
  • timezone — VARCHAR(100) — NOT NULL — 스케줄 계산 기준
  • start_at — TIMESTAMPTZ — 스케줄 실행 시작 시간
  • end_at — TIMESTAMPTZ — 스케줄 실행 종료 시간
  • next_run_at — TIMESTAMPTZ — 다음 실행 예정 시각
  • last_run_at — TIMESTAMPTZ — 마지막 실행 요청 시각
  • schedule_stat — VARCHAR(20) — NOT NULL — 스케줄 상태
  • created_at — TIMESTAMPTZ — NOT NULL
  • updated_at — TIMESTAMPTZ — NOT NULL

tb_api_operation

  • op_id — BIGINT — Primary key — NOT NULL — 기능 ID (PK)
  • api_id — BIGINT — Foreign key → tb_api_service.api_id — NOT NULL — 서비스 ID (PK)
  • op_nm — VARCHAR(200) — NOT NULL — 기능 이름 (예: 실시간 수온 관측자료 조회)
  • op_desc — TEXT
  • endpoint_path — VARCHAR(500) — NOT NULL — 기능 엔드포인트 경로 (예: /openApi/actionOpenapiInfoList.do)
  • http_method — VARCHAR(10) — NOT NULL — HTTP 메소드 (GET, POST 등)
  • request_config — JSONB — NOT NULL — 요청 파라미터/헤더/본문 설정 JSON
  • response_config — JSONB — NOT NULL — 응답 파서, 목록 경로, 성공 판정 규칙 JSON
  • auth_config — JSONB — NOT NULL — 인증 방식 및 전송 위치 설정 JSON
  • status (op_stat) — VARCHAR(20) — NOT NULL — 상태 (ACTIVE: 사용, INACTIVE: 중지)
  • created_at — TIMESTAMP WITH TIME ZONE — NOT NULL
  • updated_at — TIMESTAMP WITH TIME ZONE — NOT NULL

tb_api_service

  • api_id — BIGINT — Primary key — NOT NULL — 서비스 ID (PK)
  • api_nm — VARCHAR(200) — NOT NULL — 서비스 이름 (예: 국립수산과학원 수산정보 API)
  • provider_nm — VARCHAR(100) — NOT NULL — 제공기관 이름 (예: 국립수산과학원)
  • service_type — VARCHAR(20) — 서비스 구분(PUBLIC, INTERNAL)
  • base_url — VARCHAR(500) — NOT NULL — 공통 호출 주소 (예: https://www.nifs.go.kr)
  • documentation_url — VARCHAR(500) — 명세 페이지 주소
  • api_desc — TEXT — 서비스 상세 설명
  • api_stat — VARCHAR(20) — NOT NULL — 상태 (ACTIVE: 사용, INACTIVE: 중지)
  • created_at — TIMESTAMP WITH TIME ZONE — NOT NULL
  • updated_at — TIMESTAMP WITH TIME ZONE — NOT NULL

tb_collection_target

  • target_id — BIGINT — Primary key — NOT NULL — 저장 대상 ID(PK)
  • target_nm — VARCHAR(200) — NOT NULL — 저장 대상 이름
  • target_desc — TEXT — 저장 데이터 설명
  • schema_nm — VARCHAR(63) — NOT NULL — 스키마 명
  • table_nm — VARCHAR(63) — NOT NULL — 테이블 명
  • column_config — JSONB — NOT NULL — 고유키 구성을 정의한 JSON
  • target_stat (status) — VARCHAR(20) — NOT NULL — 저장 대상 상태
  • created_at — TIMESTAMPTZ — NOT NULL
  • updated_at — TIMESTAMPTZ — NOT NULL

tb_job_run

  • run_id — BIGINT — Primary key — NOT NULL — 수집 실행 ID(PK)
  • job_id — BIGINT — Foreign key → tb_api_job.job_id — NOT NULL — 수집 작업 ID(PK)
  • schedule_id — BIGINT — Foreign key → tb_api_job_schedule.schedule_id — NOT NULL — 수집 스케줄 ID(PK)
  • trigger_type — VARCHAR(20) — NOT NULL — 실행 발생 유형
  • run_status — VARCHAR(20) — NOT NULL — 실행 상태
  • scheduled_at — TIMESTAMPTZ — 스케줄 실행 예정 시각
  • started_at — TIMESTAMPTZ — 실행이 실제로 시작된 시각
  • finished_at — TIMESTAMPTZ — 실행 종료 시각
  • resolved_parameters — JSONB — 실행 시점의 실제 값으로 계산
  • request_count — INTEGER — NOT NULL — 총 HTTP 요청 건수
  • received_count — INTEGER — NOT NULL — 정상적으로 데이터를 추출한 건수
  • saved_count — INTEGER — NOT NULL — 실제로 저장하거나 갱신한 데이터 건수
  • failed_count — INTEGER — NOT NULL — 실패한 데이터 건수
  • error_code — VARCHAR(100) — 시스템 오류 코드
  • error_message — TEXT — 실패 사유
  • created_at — TIMESTAMPTZ — NOT NULL