ONDA

SDK

ONDA Channel API 공식 SDK 제공 계획과 REST 직접 연동 방법을 안내합니다.

ONDA Platform Engineering 관리

SDK

ONDA Channel API의 공식 SDK는 준비 중이며 아직 공개되지 않았습니다. 공개 전까지는 REST API를 직접 호출하여 연동하세요.

공개 예정 SDK

다음 언어의 공식 SDK가 공개될 예정입니다. OAuth 2.0 토큰 관리와 API 호출을 자동으로 처리합니다.

언어패키지 (예정)상태
Node.js / TypeScript@ondame/channel-node공개 예정
Pythononda-channel공개 예정
Javame.onda:channel-java공개 예정
PHPonda/channel-php공개 예정
JavaScript (Vanilla)@ondame/channel-js공개 예정
React@ondame/channel-react공개 예정
Next.js@ondame/channel-nextjs공개 예정

위 패키지명은 출시 시점에 활성화될 예정이며, 현재는 패키지 레지스트리(npm, PyPI 등)에서 설치할 수 없습니다. 출시 소식은 변경 이력에서 공지됩니다.

REST API 직접 연동

SDK 없이도 RESTful API를 직접 호출하여 모든 기능을 사용할 수 있습니다. HTTP 요청을 보낼 수 있는 모든 언어에서 연동 가능합니다.

# API Key 인증
curl -X GET "https://api.tport.dev/channel/v1/properties" \
  -H "X-Api-Key: YOUR_API_KEY"

# 또는 OAuth 2.0 Bearer 토큰
curl -X GET "https://api.tport.dev/channel/v1/properties" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

OpenAPI 3.1 명세를 코드 생성 도구(openapi-generator 등)에 입력하면 원하는 언어의 클라이언트를 직접 생성할 수도 있습니다.

# 예: TypeScript 클라이언트 생성
npx @openapitools/openapi-generator-cli generate \
  -i https://api.tport.dev/channel/v1/openapi.json \
  -g typescript-fetch \
  -o ./onda-client

다음 단계