Introduction
01.software Headless CMS - 멀티테넌트 콘텐츠 관리 플랫폼
01.software Headless CMS
01.software는 E-commerce, 콘텐츠, 미디어 관리를 위한 멀티테넌트 Headless CMS 서비스입니다.
주요 기능
| 기능 | 설명 |
|---|---|
| E-commerce | 상품, 변형, 옵션, 주문, 결제, 반품 관리 |
| 콘텐츠 | 블로그 포스트, 문서, 리치 텍스트 에디터 |
| 미디어 | 플레이리스트, 갤러리, 이미지 최적화 |
| 멀티테넌트 | 테넌트별 데이터 격리 및 API 키 관리 |
시작하기
1. SDK 설치
npm install @01.software/sdk
# 또는
pnpm add @01.software/sdk2. 클라이언트 생성
import { createBrowserClient } from '@01.software/sdk'
const client = createBrowserClient({
clientKey: 'your-client-key'
})3. 데이터 조회
// 상품 목록 조회
const response = await client.from('products').find({
limit: 10,
where: { status: { equals: 'active' } }
})
if (response.success) {
console.log(response.data) // Product[]
console.log(response.pagination) // { totalDocs, hasNextPage, ... }
}자세한 사용법은 빠른 시작 가이드를 참조하세요.
문서 구조
빠른 시작
5분 안에 첫 번째 API 호출하기
인증
Client Key와 Secret Key 사용법
SDK
TypeScript SDK 완전 가이드
API Reference
REST API 및 GraphQL 레퍼런스
SDK 특징
타입 안전성
모든 컬렉션과 응답에 대해 완전한 TypeScript 지원을 제공합니다.
// 타입이 자동으로 추론됩니다
const response = await client.from('products').find()
// response.data: Product[]
const product = await client.from('products').findById('id')
// product.data: ProductReact Query 통합
데이터 페칭과 캐싱을 위한 React 훅을 제공합니다.
import { useCollection } from '@01.software/sdk'
function ProductList() {
const { data, isLoading } = client.query.useCollection('products', {
where: { status: { equals: 'active' } }
})
if (isLoading) return <div>Loading...</div>
return <div>{data?.map(p => <div key={p.id}>{p.title}</div>)}</div>
}서버 클라이언트
Next.js App Router와 완벽하게 통합됩니다.
import { createServerClient } from '@01.software/sdk'
const client = createServerClient({
clientKey: process.env.NEXT_PUBLIC_SOFTWARE_CLIENT_KEY!,
secretKey: process.env.SOFTWARE_SECRET_KEY!
})
// Server Component에서 사용
const products = await client.from('products').find()지원 컬렉션
E-commerce
| 컬렉션 | 설명 |
|---|---|
products | 상품 정보 |
product-variants | 상품 변형 (사이즈, 색상 등) |
product-options | 상품 옵션 그룹 |
product-categories | 상품 카테고리 |
orders | 주문 |
transactions | 결제 트랜잭션 |
콘텐츠
| 컬렉션 | 설명 |
|---|---|
posts | 블로그 포스트 |
post-categories | 포스트 카테고리 |
documents | 문서 |
미디어
| 컬렉션 | 설명 |
|---|---|
playlists | 플레이리스트 |
musics | 음악 트랙 |
galleries | 갤러리 |
플랜
| 플랜 | API 호출/월 | 스토리지 | 사용자 |
|---|---|---|---|
| Free | 10,000 | 1GB | 3명 |
| Basic | 100,000 | 10GB | 10명 |
| Pro | 1,000,000 | 100GB | 50명 |
| Enterprise | 무제한 | 무제한 | 무제한 |