> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API · OData 커넥터

> HTTP API 또는 OData 서비스를 조회 시점에 라이브 호출해 데이터 소스로 등록합니다.

## 개요

API 커넥터는 HTTP API 또는 OData 서비스에 연결합니다.
데이터를 복사해 저장하지 않고 **조회 시점에 API를 라이브로 호출합니다.**

<Info>
  이 화면은 **관리자(Manager) 이상**(owner·manager)만 접근할 수 있습니다. 메뉴 가시성 `manage`.
</Info>

## 단계

<Steps>
  <Step title="요청 · 페이징">
    호출할 요청과 페이징 방식을 설정합니다.
  </Step>

  <Step title="응답 · 드릴">
    호출을 테스트하고 응답에서 데이터 위치를 드릴다운합니다.
  </Step>

  <Step title="데이터 뷰 · 필터링">
    미리보기를 확인하고 조건에 맞는 행만 사용하도록 필터를 설정합니다.
  </Step>

  <Step title="데이터 매핑">
    컬럼마다 의미(필수, 표준 필드명)와 상세(선택)를 지정합니다.
  </Step>

  <Step title="등록">
    이름을 입력하고 데이터소스를 등록합니다.
  </Step>
</Steps>

## HTTP API

| 항목        | 설명                        |
| --------- | ------------------------- |
| 메소드       | `GET` / `POST`만 가능(읽기 전용) |
| URL       | 호출 대상 주소                  |
| 헤더        | 선택 — 인증 등                 |
| 쿼리 파라미터   | 선택                        |
| 본문 (JSON) | `POST`일 때만                |

<Note>
  REQUEST 항목은 전부 선택 사항입니다 — URL만으로도 호출할 수 있습니다.
</Note>

## OData

<Steps>
  <Step title="서비스 URL 입력">
    OData 서비스 루트 URL을 입력합니다.
  </Step>

  <Step title="연결 & 엔티티셋 조회">
    연결한 뒤 엔티티셋을 선택합니다. 메소드는 `GET` 고정, 페이징은 커서 방식이 기본입니다.
  </Step>
</Steps>

## 페이징

| 방식                   | 설명                                   |
| -------------------- | ------------------------------------ |
| 없음                   | 페이징하지 않음                             |
| 파라미터 (offset · page) | 페이지/크기 파라미터로 반복 호출                   |
| 다음 링크 · 커서           | 응답의 다음 링크(예: `@odata.nextLink`)를 따라감 |

## 응답 처리

호출 테스트 후 응답 타입을 지정합니다: 자동 감지 / JSON / CSV / Excel. JSON 응답은 데이터 위치를 드릴다운해 선택합니다.

## 보안

<Warning>
  헤더 · 본문 등 자격증명은 **AES-256-GCM으로 암호화**되어 저장되며 클라이언트로 반환되지 않습니다.
  수정 시 입력란을 비워 두면 저장된 값이 유지됩니다.
</Warning>

<Warning>
  내부 · 사설 주소로의 호출은 허용되지 않습니다.
</Warning>