Quick Start

SDK 빠른 시작 가이드

SDK를 처음 사용한다면 여기서 시작하세요. SomaClient를 생성하고 login()을 호출하면 모든 API를 사용할 수 있습니다.

Setup

환경변수로 자격증명을 전달하는 것이 권장됩니다. .env 파일이나 CI/CD 시크릿에 저장하고 코드에 직접 입력하지 마세요.

import { SomaClient } from 'opensoma'

const client = new SomaClient({
  username: process.env.OPENSOMA_USERNAME,
  password: process.env.OPENSOMA_PASSWORD,
})
await client.login()

Example

const dashboard = await client.dashboard.get()
console.log(dashboard.name, dashboard.role)

const { items } = await client.mentoring.list({ status: 'open' })
console.log(`${items.length} open sessions`)

const rooms = await client.room.list({ date: '2025-01-15' })
for (const room of rooms) {
  const available = room.timeSlots.filter((s) => s.available)
  console.log(`${room.name}: ${available.length} slots available`)
}

각 API의 상세 사용법은 개별 문서를 참고하세요.