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