gateway

외부 connector 등록·discover·query·invoke·config

14 operations — 외부 connector 등록·discover·query·invoke·config

`GET /api/v1/tenants/{tenantID}/connectors`

gatewayGetApiV1TenantsByTenantIDConnectors

호출 권한: tenant_admin 관리자가 grant 와 무관하게 connector 의 모든 active resource 를 조회한다. 사용자 면 (/me/connectors/{cID}/resources) 와 동일한 응답 shape 이지만 grant 체크 없음 — 운영자 / 관리 콘솔의 카탈로그 조회용.
limit (1~500, 기본 100) · offset · q (name 부분일치)

언어	호출
node	`@ax-hub/sdk` 미제공 — 운영 패키지 `@ax-hub/admin-sdk` 의 `admin.tenant(x).connectors.list` 사용
go	`client.Gateway().GatewayGetApiV1TenantsByTenantIDConnectors(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayGetApiV1TenantsByTenantIDConnectors(pathParams, query, body)` — 비동기: `gatewayGetApiV1TenantsByTenantIDConnectorsAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayGetApiV1TenantsByTenantIDConnectors(pathParams, query, body)` — suspend
python	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_connectors(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_connectors(path_params: …, query: …, body: …)`
공통	`request("gatewayGetApiV1TenantsByTenantIDConnectors", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

Query 파라미터 — query 로 전달 (문자열 값)

이름	타입	설명
`enabled_only`	boolean	true 면 enabled=true 만
`limit`	integer	페이지 크기 (기본 100, 1~500 clamp)
`offset`	integer	오프셋 (기본 0)
`q`	string	name 부분일치 필터

응답 — 200 · OK

배열 응답 → SDK 는 {"value": [...]} 로 감싸 반환. 원소 필드:

이름	타입	설명
`attributes`	object
`classification`	array<string>
`connectorId` (wire: `connector_id`)	string
`createdAt` (wire: `created_at`)	string
`id`	string
`kind`	string
`name`	string
`parentId` (wire: `parent_id`)	string
`path`	string
`tenantId` (wire: `tenant_id`)	string
`updatedAt` (wire: `updated_at`)	string

에러 status: 400 401 403 500 — 에러 처리

`GET /api/v1/tenants/{tenantID}/connectors/{connectorID}`

gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorID

호출 권한: tenant_admin

언어	호출
node	`@ax-hub/sdk` 미제공 — 운영 패키지 `@ax-hub/admin-sdk` 의 `admin.tenant(x).connectors.get` 사용
go	`client.Gateway().GatewayGetApiV1TenantsByTenantIDConnectorsByConnectorID(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorID(pathParams, query, body)` — 비동기: `gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorID(pathParams, query, body)` — suspend
python	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_connectors_by_connector_id(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_connectors_by_connector_id(path_params: …, query: …, body: …)`
공통	`request("gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorID", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID
`connectorID` 필수	string	connector UUID

응답 — 200 · OK

이름	타입	설명
`classification`	array<string>	Classification 은 자유 태그.
`config`	object	Config 는 engine 별 설정 (credential 제외).
`createdAt` (wire: `created_at`)	string
`description`	string	Description 은 admin 메모.
`enabled`	boolean
`engine`	string	Engine 은 postgres / mysql / mssql / oracle / clickhouse / vertica / rest-api + mysql wire-compatible alias (mariadb / tidb / singlestore) + postgres wire-compatible alias (cockroachdb / yugabytedb / redshift / greenplum / spanner) + oracle alias (tibero). alias 는 UI / catalog 식별만 별, driver / discovery 동일. Aurora / Azure 같은 cloud-managed wrapper 는 host 만 다른 같은 product 라 별도 카드 없이 mysql / postgres / mssql 사용.
`id`	string	ID 는 connector UUID.
`kind`	string	Kind 는 db / api.
`lastDiscoveredAt` (wire: `last_discovered_at`)	string	LastDiscoveredAt 는 마지막 발견 시각.
`name`	string	Name 은 unique connector 이름.
`tenantId` (wire: `tenant_id`)	string	TenantID 는 소속 tenant UUID.
`updatedAt` (wire: `updated_at`)	string

에러 status: 400 401 403 404 500 — 에러 처리

`POST /api/v1/tenants/{tenantID}/connectors/{connectorID}/discover`

gatewayPostApiV1TenantsByTenantIDConnectorsByConnectorIDDiscover

관리자가 등록 직후 5분 cron 안 기다리고 즉시 스키마/테이블/컬럼을 발견시킨다. 응답으로 발견된 tables/columns 카운트 + schemas + 일부 preview 를 반환.

호출 권한: tenant_admin
부수 효과: 발견 성공 시 connectors.last_discovered_at 갱신, 새 path INSERT, 사라진 path SoftDelete
REST connector 등 discoverer 없는 engine 은 zero-value 응답 (정상 200)

언어	호출
node	`@ax-hub/sdk` 미제공 — 운영 패키지 `@ax-hub/admin-sdk` 의 `admin.tenant(x).connectors.discover` 사용
go	`client.Gateway().GatewayPostApiV1TenantsByTenantIDConnectorsByConnectorIDDiscover(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayPostApiV1TenantsByTenantIDConnectorsByConnectorIDDiscover(pathParams, query, body)` — 비동기: `gatewayPostApiV1TenantsByTenantIDConnectorsByConnectorIDDiscoverAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayPostApiV1TenantsByTenantIDConnectorsByConnectorIDDiscover(pathParams, query, body)` — suspend
python	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_connectors_by_connector_id_discover(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_connectors_by_connector_id_discover(path_params: …, query: …, body: …)`
공통	`request("gatewayPostApiV1TenantsByTenantIDConnectorsByConnectorIDDiscover", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID
`connectorID` 필수	string	connector UUID

응답 — 200 · OK

이름	타입	설명
`columnsCount` (wire: `columns_count`)	integer	ColumnsCount 는 active 컬럼 row 수 (sweep 후 재집계).
`lastDiscoveredAt` (wire: `last_discovered_at`)	string	LastDiscoveredAt 는 connectors.last_discovered_at 갱신 시각. discoverer 미지원 engine (REST 등) 면 null.
`preview`	array<object>	Preview 는 발견된 table 일부 (최대 20개) — UI 카드 미리보기용.
`schemas`	array<string>	Schemas 는 발견된 스키마(또는 database) 이름 목록.
`tablesCount` (wire: `tables_count`)	integer	TablesCount 는 이번 sweep 에서 engine 이 보고한 table 수.

에러 status: 400 401 403 404 500 — 에러 처리

`GET /api/v1/tenants/{tenantID}/connectors/{connectorID}/resources`

gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDResources

호출 권한: tenant_admin 관리자가 grant 와 무관하게 connector 의 모든 active resource 를 조회한다. 사용자 면 (/me/connectors/{cID}/resources) 와 동일한 응답 shape 이지만 grant 체크 없음 — 운영자 / 관리 콘솔의 카탈로그 조회용.
limit (1~500, 기본 100) · offset · q (name 부분일치)

언어	호출
node	`@ax-hub/sdk` 미제공 — 운영 패키지 `@ax-hub/admin-sdk` 의 `admin.tenant(x).connectors.resources` 사용
go	`client.Gateway().GatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDResources(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDResources(pathParams, query, body)` — 비동기: `gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDResourcesAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDResources(pathParams, query, body)` — suspend
python	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_connectors_by_connector_id_resources(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_connectors_by_connector_id_resources(path_params: …, query: …, body: …)`
공통	`request("gatewayGetApiV1TenantsByTenantIDConnectorsByConnectorIDResources", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID
`connectorID` 필수	string	connector UUID

Query 파라미터 — query 로 전달 (문자열 값)

이름	타입	설명
`enabled_only`	boolean	true 면 enabled=true 만
`limit`	integer	페이지 크기 (기본 100, 1~500 clamp)
`offset`	integer	오프셋 (기본 0)
`q`	string	name 부분일치 필터

응답 — 200 · OK

배열 응답 → SDK 는 {"value": [...]} 로 감싸 반환. 원소 필드:

이름	타입	설명
`attributes`	object
`classification`	array<string>
`connectorId` (wire: `connector_id`)	string
`createdAt` (wire: `created_at`)	string
`id`	string
`kind`	string
`name`	string
`parentId` (wire: `parent_id`)	string
`path`	string
`tenantId` (wire: `tenant_id`)	string
`updatedAt` (wire: `updated_at`)	string

에러 status: 400 401 403 500 — 에러 처리

`POST /api/v1/tenants/{tenantID}/gateway/document-invoke`

gatewayPostApiV1TenantsByTenantIDGatewayDocumentInvoke

MongoDB connector 의 op 를 실행한다.

호출 권한: tenant_member (session 의 grant 보유 필요)
입력: session_id · op (find/insertOne 등) · collection · 기타 op-별 필드
권한: op → SQL action 매핑 (find→SELECT, insertOne→INSERT 등) 후 preset.Allows 체크 (spec 039 §R2)
부수 효과: audit emit (TypeAPICall), connector pool 캐시

언어	호출
node	`sdk.gateway.documentInvoke(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayPostApiV1TenantsByTenantIDGatewayDocumentInvoke(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayPostApiV1TenantsByTenantIDGatewayDocumentInvoke(pathParams, query, body)` — 비동기: `gatewayPostApiV1TenantsByTenantIDGatewayDocumentInvokeAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayPostApiV1TenantsByTenantIDGatewayDocumentInvoke(pathParams, query, body)` — suspend
python	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_document_invoke(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_document_invoke(path_params: …, query: …, body: …)`
공통	`request("gatewayPostApiV1TenantsByTenantIDGatewayDocumentInvoke", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

Request Body — body 로 전달, wire 키(snake_case) 그대로

이름	타입	설명
`collection`	string
`database`	string
`document`	object
`documents`	array<any>
`field`	string
`filter`	object
`limit`	integer
`op`	string
`pipeline`	array<any>
`projection`	object
`session_id`	string
`skip`	integer
`sort`	object
`update`	object

응답 — 200 · 실행 결과

이름	타입	설명
`count`	integer
`deletedCount` (wire: `deleted_count`)	integer
`distinct`	array<any>
`documents`	array<object>
`insertedCount` (wire: `inserted_count`)	integer
`insertedIds` (wire: `inserted_ids`)	array<any>
`matchedCount` (wire: `matched_count`)	integer
`modifiedCount` (wire: `modified_count`)	integer
`op`	string

에러 status: 400 401 403 404 500 — 에러 처리

`POST /api/v1/tenants/{tenantID}/gateway/file-invoke`

gatewayPostApiV1TenantsByTenantIDGatewayFileInvoke

Google Drive connector 의 file action 을 실행한다.

호출 권한: tenant_member (session 의 grant 보유 필요)
입력: session_id · action (file:list|file:get|file:search) · 기타 action-별 필드
권한: action 그대로 preset.Allows 체크 — native vocab (SQL 매핑 X)
응답: Drive API raw shape (id, name, mimeType, size, modifiedTime, parents, webViewLink). 본문 stream X.
부수 효과: audit emit (TypeAPICall). refresh_token revoke 시 connector auth_status='auth_expired' 전이.

언어	호출
node	미제공
go	`client.Gateway().GatewayPostApiV1TenantsByTenantIDGatewayFileInvoke(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayPostApiV1TenantsByTenantIDGatewayFileInvoke(pathParams, query, body)` — 비동기: `gatewayPostApiV1TenantsByTenantIDGatewayFileInvokeAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayPostApiV1TenantsByTenantIDGatewayFileInvoke(pathParams, query, body)` — suspend
python	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_file_invoke(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_file_invoke(path_params: …, query: …, body: …)`
공통	`request("gatewayPostApiV1TenantsByTenantIDGatewayFileInvoke", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

Request Body — body 로 전달, wire 키(snake_case) 그대로

이름	타입	설명
`action`	string	Action 은 file:list / file:get / file:search 중 하나.
`file_id`	string	FileID 는 file:get 의 대상.
`parent_folder_id`	string	ParentFolderID 는 file:list 의 parent. 비우면 Shared Drive root.
`q`	string	Q 는 file:search 의 Drive query string.
`session_id`	string	SessionID 는 사전 발급된 gateway session id.

응답 — 200 · OK

이름	타입	설명
`action`	string	Action 은 file:list / file:get / file:search 중 하나.
`file`	object	File 은 file:get 의 단건 결과.
`files`	array<object>	Files 는 file:list / file:search 의 결과 배열.

에러 status: 400 401 403 404 500 503 — 에러 처리

`POST /api/v1/tenants/{tenantID}/gateway/invoke`

gatewayPostApiV1TenantsByTenantIDGatewayInvoke

5단계: authz → policy in → engine.Invoke → policy out → audit.

호출 권한: tenant_member

언어	호출
node	`sdk.gateway(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayPostApiV1TenantsByTenantIDGatewayInvoke(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayPostApiV1TenantsByTenantIDGatewayInvoke(pathParams, query, body)` — 비동기: `gatewayPostApiV1TenantsByTenantIDGatewayInvokeAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayPostApiV1TenantsByTenantIDGatewayInvoke(pathParams, query, body)` — suspend
python	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_invoke(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_invoke(path_params: …, query: …, body: …)`
공통	`request("gatewayPostApiV1TenantsByTenantIDGatewayInvoke", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

Request Body — body 로 전달, wire 키(snake_case) 그대로

이름	타입	설명
`body`	array<integer>
`headers`	object
`method`	string
`path`	string
`session_id`	string

응답 — 200 · OK

이름	타입	설명
`body`	array<integer>
`headers`	object
`statusCode` (wire: `status_code`)	integer

에러 status: 400 401 403 404 500 — 에러 처리

`POST /api/v1/tenants/{tenantID}/gateway/query`

gatewayPostApiV1TenantsByTenantIDGatewayQuery

5단계: authz → policy in → engine.Execute → policy out → audit.

호출 권한: tenant_member
입력: session_id · sql · params? · action?
부수 효과: audit query emit (allow/deny/error)

언어	호출
node	`sdk.gateway(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayPostApiV1TenantsByTenantIDGatewayQuery(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayPostApiV1TenantsByTenantIDGatewayQuery(pathParams, query, body)` — 비동기: `gatewayPostApiV1TenantsByTenantIDGatewayQueryAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayPostApiV1TenantsByTenantIDGatewayQuery(pathParams, query, body)` — suspend
python	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_query(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_query(path_params: …, query: …, body: …)`
공통	`request("gatewayPostApiV1TenantsByTenantIDGatewayQuery", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

Request Body — body 로 전달, wire 키(snake_case) 그대로

이름	타입	설명
`action`	string
`params`	array<any>
`session_id`	string
`sql`	string

응답 — 200 · OK

이름	타입	설명
`columns`	array<object>
`rows`	array<array>

에러 status: 400 401 403 404 500 — 에러 처리

`POST /api/v1/tenants/{tenantID}/gateway/sessions`

gatewayPostApiV1TenantsByTenantIDGatewaySessions

사용자가 connector 에 대한 active grant 의 preset 을 snapshot 으로 8시간 TTL session 시작.

호출 권한: tenant_member
입력: connector_id · mfa_verified?
부수 효과: gateway_sessions INSERT

언어	호출
node	`sdk.gateway(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayPostApiV1TenantsByTenantIDGatewaySessions(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayPostApiV1TenantsByTenantIDGatewaySessions(pathParams, query, body)` — 비동기: `gatewayPostApiV1TenantsByTenantIDGatewaySessionsAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayPostApiV1TenantsByTenantIDGatewaySessions(pathParams, query, body)` — suspend
python	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_sessions(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_post_api_v1_tenants_by_tenant_id_gateway_sessions(path_params: …, query: …, body: …)`
공통	`request("gatewayPostApiV1TenantsByTenantIDGatewaySessions", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

Request Body — body 로 전달, wire 키(snake_case) 그대로

이름	타입	설명
`connector_id`	string
`mfa_verified`	boolean

응답 — 201 · Created

이름	타입	설명
`connectorId` (wire: `connector_id`)	string
`endedAt` (wire: `ended_at`)	string
`expiresAt` (wire: `expires_at`)	string
`grantId` (wire: `grant_id`)	string
`id`	string
`presetId` (wire: `preset_id`)	string
`startedAt` (wire: `started_at`)	string
`subjectId` (wire: `subject_id`)	string
`tenantId` (wire: `tenant_id`)	string

에러 status: 400 401 403 404 500 — 에러 처리

`DELETE /api/v1/tenants/{tenantID}/gateway/sessions/{sessionID}`

gatewayDeleteApiV1TenantsByTenantIDGatewaySessionsBySessionID

호출 권한: tenant_member (자기 세션만)

언어	호출
node	`sdk.gateway(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayDeleteApiV1TenantsByTenantIDGatewaySessionsBySessionID(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayDeleteApiV1TenantsByTenantIDGatewaySessionsBySessionID(pathParams, query, body)` — 비동기: `gatewayDeleteApiV1TenantsByTenantIDGatewaySessionsBySessionIDAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayDeleteApiV1TenantsByTenantIDGatewaySessionsBySessionID(pathParams, query, body)` — suspend
python	`client.gateway.gateway_delete_api_v1_tenants_by_tenant_id_gateway_sessions_by_session_id(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_delete_api_v1_tenants_by_tenant_id_gateway_sessions_by_session_id(path_params: …, query: …, body: …)`
공통	`request("gatewayDeleteApiV1TenantsByTenantIDGatewaySessionsBySessionID", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID
`sessionID` 필수	string	session UUID

응답 — 204 · No Content

본문 없음 → SDK 는 빈 map {} 반환

에러 status: 400 401 403 404 500 — 에러 처리

`GET /api/v1/tenants/{tenantID}/me/connectors`

gatewayGetApiV1TenantsByTenantIDMeConnectors

현재 사용자가 active grant 를 가진 connector 들을 반환. 없는 connector 는 노출 0 (FR-018).

호출 권한: tenant_member

언어	호출
node	`sdk.gateway(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayGetApiV1TenantsByTenantIDMeConnectors(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayGetApiV1TenantsByTenantIDMeConnectors(pathParams, query, body)` — 비동기: `gatewayGetApiV1TenantsByTenantIDMeConnectorsAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayGetApiV1TenantsByTenantIDMeConnectors(pathParams, query, body)` — suspend
python	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_me_connectors(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_me_connectors(path_params: …, query: …, body: …)`
공통	`request("gatewayGetApiV1TenantsByTenantIDMeConnectors", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

응답 — 200 · OK

배열 응답 → SDK 는 {"value": [...]} 로 감싸 반환. 원소 필드:

이름	타입	설명
`classification`	array<string>	Classification 은 자유 태그.
`config`	object	Config 는 engine 별 설정 (credential 제외).
`createdAt` (wire: `created_at`)	string
`description`	string	Description 은 admin 메모.
`enabled`	boolean
`engine`	string	Engine 은 postgres / mysql / mssql / oracle / clickhouse / vertica / rest-api + mysql wire-compatible alias (mariadb / tidb / singlestore) + postgres wire-compatible alias (cockroachdb / yugabytedb / redshift / greenplum / spanner) + oracle alias (tibero). alias 는 UI / catalog 식별만 별, driver / discovery 동일. Aurora / Azure 같은 cloud-managed wrapper 는 host 만 다른 같은 product 라 별도 카드 없이 mysql / postgres / mssql 사용.
`id`	string	ID 는 connector UUID.
`kind`	string	Kind 는 db / api.
`lastDiscoveredAt` (wire: `last_discovered_at`)	string	LastDiscoveredAt 는 마지막 발견 시각.
`name`	string	Name 은 unique connector 이름.
`tenantId` (wire: `tenant_id`)	string	TenantID 는 소속 tenant UUID.
`updatedAt` (wire: `updated_at`)	string

에러 status: 401 403 500 — 에러 처리

`GET /api/v1/tenants/{tenantID}/me/connectors/{connectorID}/resources`

gatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResources

active grant 없는 connector 는 404 — 메타데이터 자체 노출 0 (FR-018).

호출 권한: tenant_member

언어	호출
node	`sdk.gateway(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().GatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResources(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResources(pathParams, query, body)` — 비동기: `gatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResourcesAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResources(pathParams, query, body)` — suspend
python	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_me_connectors_by_connector_id_resources(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_get_api_v1_tenants_by_tenant_id_me_connectors_by_connector_id_resources(path_params: …, query: …, body: …)`
공통	`request("gatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResources", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID
`connectorID` 필수	string	connector UUID

Query 파라미터 — query 로 전달 (문자열 값)

이름	타입	설명
`limit`	integer	페이지 크기 (기본 100, 1~500 clamp)
`offset`	integer	오프셋 (기본 0)
`q`	string	name 부분일치 필터 (대소문자 무시)

응답 — 200 · OK

배열 응답 → SDK 는 {"value": [...]} 로 감싸 반환. 원소 필드:

이름	타입	설명
`attributes`	object
`classification`	array<string>
`connectorId` (wire: `connector_id`)	string
`createdAt` (wire: `created_at`)	string
`id`	string
`kind`	string
`name`	string
`parentId` (wire: `parent_id`)	string
`path`	string
`tenantId` (wire: `tenant_id`)	string
`updatedAt` (wire: `updated_at`)	string

에러 status: 401 403 404 500 — 에러 처리

`GET /config/public`

configGetConfigPublic

로그인 / 로그아웃 / 만료 토큰 상태와 무관하게 호출 가능한 익명 endpoint. FE 가 부트스트랩 시 1회 호출 후 메모리 캐시. 현재 base_domain 만 반환.

언어	호출
node	`sdk.config.public(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Gateway().ConfigGetConfigPublic(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().configGetConfigPublic(pathParams, query, body)` — 비동기: `configGetConfigPublicAsync(…)` → CompletableFuture
kotlin	`client.gateway.configGetConfigPublic(pathParams, query, body)` — suspend
python	`client.gateway.config_get_config_public(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.config_get_config_public(path_params: …, query: …, body: …)`
공통	`request("configGetConfigPublic", pathParams, query, body)`

응답 — 200 · OK

이름	타입	설명
`baseDomain` (wire: `base_domain`)	string

에러 status: 429 — 에러 처리

`GET /oauth/google/callback`

gatewayGetOauthGoogleCallback

Google 동의 후 redirect 받는 endpoint. code + code_verifier 로 token 교환, Shared Drive 목록 응답. 사용자가 1개 선택 후 finalize 호출.

호출 권한: 인증된 사용자 (state 가 secret 역할 — 10분 TTL).
입력: code · state (query string)
부수 효과: oauth_states row 갱신 (callback_payload 채움)

언어	호출
node	미제공
go	`client.Gateway().GatewayGetOauthGoogleCallback(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.gateway().gatewayGetOauthGoogleCallback(pathParams, query, body)` — 비동기: `gatewayGetOauthGoogleCallbackAsync(…)` → CompletableFuture
kotlin	`client.gateway.gatewayGetOauthGoogleCallback(pathParams, query, body)` — suspend
python	`client.gateway.gateway_get_oauth_google_callback(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.gateway.gateway_get_oauth_google_callback(path_params: …, query: …, body: …)`
공통	`request("gatewayGetOauthGoogleCallback", pathParams, query, body)`

Query 파라미터 — query 로 전달 (문자열 값)

이름	타입	설명
`code` 필수	string	Google authorization code
`state` 필수	string	start 단계에서 발급된 state
`error`	string	Google 에서 사용자 거부 시 access_denied

응답 — 200 · Shared Drive 목록

이름	타입	설명
`drives`	array<object>
`returnTo` (wire: `return_to`)	string
`state`	string
`tenantId` (wire: `tenant_id`)	string

에러 status: 400 401 500 — 에러 처리