> ## 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를 라이브로 호출합니다.**

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

## 단계

**1. 요청 · 페이징**

호출할 요청과 페이징 방식을 설정합니다.

**2. 응답 · 드릴**

호출을 테스트하고 응답에서 데이터 위치를 드릴다운합니다.

**3. 데이터 뷰 · 필터링**

미리보기를 확인하고 조건에 맞는 행만 사용하도록 필터를 설정합니다.

**4. 데이터 매핑**

컬럼마다 의미(필수, 표준 필드명)와 상세(선택)를 지정합니다.

**5. 등록**

이름을 입력하고 데이터소스를 등록합니다.

## HTTP API

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

> [!NOTE]
>
> REQUEST 항목은 전부 선택 사항입니다 — URL만으로도 호출할 수 있습니다.

## OData

**1. 서비스 URL 입력**

OData 서비스 루트 URL을 입력합니다.

**2. 연결 & 엔티티셋 조회**

연결한 뒤 엔티티셋을 선택합니다. 메소드는 `GET` 고정, 페이징은 커서 방식이 기본입니다.

## 페이징

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

## 응답 처리

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

## 보안

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

> [!WARNING]
>
> 내부 · 사설 주소로의 호출은 허용되지 않습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.