웹 스토리지 (Web Storage)

정적 웹사이트 호스팅 기능입니다. 콘솔에서 웹 스토리지를 생성·배포한 뒤, SDK로는 **페이지별 메타데이터(SEO/OG 태그)**를 관리할 수 있습니다.

⚠️ 웹 스토리지 생성·배포 자체는 콘솔과 REST API 또는 Connect Base CLI 로 진행합니다. SDK에는 cb.webStorage 모듈이 없으며, SEO 메타데이터만 cb.storage.setPageMeta 등으로 다룰 수 있습니다.

페이지 메타 (OG 태그 / JSON-LD)

typescript

await cb.storage.setPageMeta('web_storage_id', {
  path: '/products/123',
  title: '최신 스마트폰 - 내 쇼핑몰',
  description: '최고의 성능, 최저가 보장',
  image: 'https://example.com/product.jpg',
  og_type: 'product',
  json_ld: JSON.stringify({
    '@context': 'https://schema.org',
    '@type': 'Product',
    name: '최신 스마트폰',
    offers: { '@type': 'Offer', price: '999000', priceCurrency: 'KRW' }
  })
})

일괄 설정 (최대 100개)

typescript

await cb.storage.batchSetPageMeta('web_storage_id', {
  pages: [
    { path: '/products/1', title: '상품 1', description: '설명 1' },
    { path: '/products/2', title: '상품 2', description: '설명 2' }
  ]
})

조회 / 삭제

typescript

// 단일 조회
const meta = await cb.storage.getPageMeta('web_storage_id', '/products/123')

// 페이지네이션 목록
const list = await cb.storage.listPageMetas('web_storage_id', { limit: 20, offset: 0 })

// 단일 삭제
await cb.storage.deletePageMeta('web_storage_id', '/products/123')

// 전체 삭제
await cb.storage.deleteAllPageMetas('web_storage_id')

함께 보기

REST API · Storage — 웹 스토리지 생성·파일 업로드·배포 엔드포인트
Connect Base CLI — 빌드된 정적 사이트를 한 줄로 배포하는 방법

HTTP API

웹 스토리지 목록 조회 / 생성

bash

# 목록
curl -X GET "https://api.connectbase.world/v1/public/storages/webs" \
  -H "X-Public-Key: cb_pk_your_public_key"

# 생성
curl -X POST "https://api.connectbase.world/v1/public/storages/webs" \
  -H "X-Public-Key: cb_pk_your_public_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-website",
    "description": "내 웹사이트"
  }'

CLI 배포

bash

# 프로덕션
curl -X POST "https://api.connectbase.world/v1/public/storages/webs/web_xxx/deploy" \
  -H "X-Public-Key: cb_pk_your_public_key" \
  -F "[email protected]"

# Dev 환경
curl -X POST "https://api.connectbase.world/v1/public/storages/webs/web_xxx/deploy/dev" \
  -H "X-Public-Key: cb_pk_your_public_key" \
  -F "[email protected]"

📌 보통 npx connectbase deploy [dir] CLI 가 이 엔드포인트를 자동으로 호출합니다. 자세한 페이지 메타 엔드포인트는 REST API · Web Storage 를 참고하세요.

스토리지 (Storage)

함수 (Functions)