connector-catalog-public@1.0.0
공개 커넥터 카탈로그
Apus가 공개한 커넥터 유형과 각 유형의 준비 상태를 확인하세요. 인증이 필요 없습니다.
고정된 계약 버전 1.0.0으로 만들었습니다. 고정된 버전은 수정되지 않습니다.
작업
get/v1/public/connectors
페이지 나눔 없이 전체 카탈로그를 한 번에 반환합니다. 보관한 ETag를 If-None-Match로 보내면 변경이 없을 때 304를 받습니다.
인증 필요 없음 · getPublicConnectorCatalog
매개변수
| 이름 | 위치 | 유형 | 필수 |
|---|---|---|---|
| If-None-Match | header | string | 아니요 |
응답
200— 현재 카탈로그입니다. 빈 배열도 유효하며 아직 공개된 항목이 없다는 뜻입니다.304— 보낸 ETag 이후 카탈로그가 바뀌지 않았습니다.500— 카탈로그를 만들 수 없습니다. 빈 카탈로그가 아니라 데이터 없음으로 처리하세요.
데이터 모델
ConnectorCatalog
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| contract | "connector-catalog-public/1.0.0" | 예 | 제공 중인 계약 버전입니다. |
| generated_at | string (date-time) | 예 | 카탈로그 생성 시각(UTC, RFC 3339). |
| connectors | PublicConnector[] | 예 | 공개된 모든 유형이며 비어 있을 수 있습니다. |
PublicConnector
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| key | string | 예 | 커넥터 유형의 영구 식별자로 링크 앵커로 써도 안전합니다. |
| name | string | 예 | 표시 이름이며 비교에 사용하지 마세요. |
| direction | inbound_api | webhook_out | polling_adapter | 예 | 데이터 방향: API로 수신, 서명된 웹훅으로 발신, 또는 주기적 수집. |
| status | live | beta | roadmap | 예 | 준비 상태: live, beta 또는 roadmap. |
| summary | string | 아니요 | 선택 사항인 짧은 설명. |
| docs_url | string (uri) | 아니요 | 이 유형의 공개 문서 페이지(선택 사항). |