2

Tables (6)

tb_api_auth

  • auth_id — BIGINT — Primary key — NOT NULL — API 인증정보 ID
  • op_id — BIGINT — Foreign key → tb_api_operation.op_id — NOT NULL — 인증정보가 속한 API 기능 ID
  • auth_nm — VARCHAR(100) — NOT NULL — 화면에 표시할 인증정보 이름
  • auth_type — VARCHAR(20) — NOT NULL — 인증 유형: API_KEY, BASIC, BEARER, OAUTH2, CUSTOM
  • user_account — VARCHAR(200) — 인증정보를 발급받은 계정 또는 이메일
  • secret_key — TEXT — NOT NULL — 암호화하여 저장하는 실제 인증값
  • expires_at — DATE — 인증정보 만료일. 만료일이 없으면 NULL
  • auth_stat — VARCHAR(20) — NOT NULL — 인증정보 상태: ACTIVE, INACTIVE, EXPIRED, REVOKED

tb_api_job

  • job_id — BIGINT — Primary key — NOT NULL — API 작업 ID
  • op_id — BIGINT — Foreign key → tb_api_operation.op_id — NOT NULL — API 기능 ID
  • auth_id — BIGINT — Foreign key → tb_api_auth.auth_id — 작업에서 선택한 기능별 인증정보 ID. 인증이 없으면 NULL
  • target_id — BIGINT — Foreign key → tb_collection_target.target_id — 작업에서 선택한 기능별 저장 대상 ID. 호출 전용 작업이면 NULL
  • job_nm — VARCHAR(200) — NOT NULL — 작업 이름
  • job_type — VARCHAR(20) — NOT NULL — 작업 유형: COLLECT(호출 후 저장), CALL_ONLY(호출만 수행)
  • job_stat — VARCHAR(20) — NOT NULL — 작업 상태: DRAFT(설정 중), ACTIVE(실행 가능), INACTIVE(중지)
  • parameter_config — JSONB — NOT NULL — Operation이 정의한 요청 항목에 넣을 고정값 및 동적 값 생성 규칙
  • storage_config — JSONB — 응답값·요청값·실행값과 Target 컬럼의 매핑, 변환 및 저장 방식
  • execution_config — JSONB — NOT NULL — 타임아웃, 재시도, 페이지 제한, 중복 실행 및 동시 실행 정책
  • job_desc — TEXT — API 작업 설명
  • schedule_type — VARCHAR(20) — NOT NULL — 스케줄 유형: MANUAL, CRON, INTERVAL, ONCE
  • schedule_stat — VARCHAR(20) — NOT NULL — 자동 실행 상태: ACTIVE, INACTIVE
  • cron_expression — VARCHAR(100) — schedule_type이 CRON일 때 사용하는 Cron 표현식
  • interval_value — INTEGER — schedule_type이 INTERVAL일 때 사용하는 반복 간격 값
  • interval_unit — VARCHAR(20) — 반복 간격 단위: MINUTE, HOUR, DAY, WEEK, MONTH, YEAR
  • timezone — VARCHAR(100) — NOT NULL — 스케줄 계산에 사용하는 시간대
  • start_at — TIMESTAMPTZ — 스케줄 적용 시작 시각. ONCE 유형에서는 단일 실행 예정 시각
  • end_at — TIMESTAMPTZ — 스케줄 적용 종료 시각
  • next_run_at — TIMESTAMPTZ — 스케줄러가 계산한 다음 실행 예정 시각
  • last_run_at — TIMESTAMPTZ — 스케줄러가 마지막으로 실행을 요청한 시각

tb_api_operation

  • op_id — BIGINT — Primary key — NOT NULL — API 기능 ID
  • api_id — BIGINT — Foreign key → tb_api_service.api_id — NOT NULL — 기능이 속한 API 서비스 ID
  • op_nm — VARCHAR(200) — NOT NULL — 기능 이름
  • op_desc — TEXT — 기능 설명
  • op_stat — VARCHAR(20) — NOT NULL — 기능 상태: DRAFT, ACTIVE, INACTIVE
  • endpoint_path — VARCHAR(500) — NOT NULL — API 서비스 base_url 뒤에 결합하는 기능별 엔드포인트 경로
  • http_method — VARCHAR(10) — NOT NULL — HTTP 요청 메서드
  • request_config — JSONB — NOT NULL — 요청 파라미터·헤더·본문의 이름, 타입, 필수 여부, 전달 위치 및 날짜 형식 정의
  • response_config — JSONB — NOT NULL — 응답 형식, 성공 판정, 목록·단일값 경로 및 페이지네이션 정의
  • auth_config — JSONB — NOT NULL — 인증 방식과 인증값의 요청 이름 및 전달 위치 정의. 실제 인증값은 저장하지 않음

tb_api_service

  • api_id — BIGINT — Primary key — NOT NULL — API 서비스 ID
  • api_nm — VARCHAR(200) — NOT NULL — API 서비스 이름
  • provider_nm — VARCHAR(100) — NOT NULL — API 제공 또는 인증 발급 기관 이름
  • data_provider_nm — VARCHAR(100) — 실제 데이터 제공기관 이름
  • service_type — VARCHAR(20) — NOT NULL — 서비스 구분: PUBLIC(공공·외부 API), INTERNAL(내부 API)
  • document_url — VARCHAR(500) — API 명세 페이지 또는 문서 주소
  • base_url — VARCHAR(500) — NOT NULL — 기능별 엔드포인트 앞에 결합하는 공통 호출 주소
  • api_stat — VARCHAR(20) — NOT NULL — API 서비스 상태: DRAFT, ACTIVE, INACTIVE
  • api_desc — TEXT — API 서비스 설명

tb_collection_target

  • target_id — BIGINT — Primary key — NOT NULL — 저장 대상 ID
  • op_id — BIGINT — Foreign key → tb_api_operation.op_id — NOT NULL — 저장 대상이 속한 API 기능 ID
  • target_nm — VARCHAR(200) — NOT NULL — 화면에 표시할 저장 대상 이름
  • target_stat — VARCHAR(20) — NOT NULL — 저장 대상 상태: DRAFT, ACTIVE, INACTIVE, ERROR
  • schema_nm — VARCHAR(63) — NOT NULL — 생성하거나 사용할 데이터베이스 스키마명
  • table_nm — VARCHAR(63) — NOT NULL — 생성하거나 사용할 물리 테이블명
  • column_config — JSONB — NOT NULL — 컬럼명, 자료형, 길이, NULL 여부, PK, 기본값 및 코멘트 정의 JSON
  • target_desc — TEXT — 저장 대상 설명

tb_job_run

  • run_id — BIGINT — Primary key — NOT NULL — 작업 실행 ID
  • job_id — BIGINT — Foreign key → tb_api_job.job_id — NOT NULL — 실행한 API 작업 ID
  • trigger_type — VARCHAR(20) — NOT NULL — 실행 발생 유형: MANUAL, SCHEDULE, RETRY
  • run_status — VARCHAR(20) — NOT NULL — 실행 상태: WAITING, RUNNING, SUCCESS, PARTIAL_SUCCESS, FAILED, CANCELLED, SKIPPED
  • scheduled_at — TIMESTAMPTZ — 스케줄에 의해 계산된 실행 예정 시각. 수동 실행이면 NULL 가능
  • 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 — 실행 실패 또는 부분 실패 상세 사유