웹 스토리지 API

정적 웹사이트(HTML/CSS/JS) 호스팅 엔드포인트입니다.

웹 스토리지 목록 조회

GET /v1/public/storages/webs

bash

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

웹 스토리지 생성

POST /v1/public/storages/webs

bash

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 배포

POST /v1/public/storages/webs/:storageID/deploy — 배포 (auto: production 즉시 / manual: QA 환경) POST /v1/public/storages/webs/:storageID/deploy?target=qa — QA 채널 배포 (promote_mode 무관 QA-only, --dev 별칭) GET /v1/public/storages/webs/:storageID/deployments — 릴리스 이력 + production/QA 포인터 POST /v1/public/storages/webs/:storageID/promote — production 승격 (body deployment_id 미지정 시 최신 ready, 과거 id = 롤백)

보통 이 엔드포인트는 npx connectbase deploy [dir] CLI 가 자동으로 호출합니다. 직접 호출하려면 multipart/form-data 로 빌드된 정적 파일을 업로드합니다.

페이지 메타 (SEO)

웹 스토리지에 배포된 페이지마다 OG 태그/JSON-LD 를 설정할 수 있습니다.

페이지 메타 설정 (Upsert)

PUT /v1/public/storages/webs/:storageID/page-metas

bash

curl -X PUT "https://api.connectbase.world/v1/public/storages/webs/stg_xxx/page-metas" \
  -H "X-Public-Key: cb_pk_your_public_key" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "/products/123",
    "title": "최신 스마트폰",
    "description": "최고의 성능, 최저가 보장",
    "image": "https://example.com/product.jpg",
    "og_type": "product"
  }'

일괄 설정 (최대 100개)

POST /v1/public/storages/webs/:storageID/page-metas/batch

bash

curl -X POST "https://api.connectbase.world/v1/public/storages/webs/stg_xxx/page-metas/batch" \
  -H "X-Public-Key: cb_pk_your_public_key" \
  -H "Content-Type: application/json" \
  -d '{
    "pages": [
      { "path": "/products/1", "title": "상품 1", "description": "설명 1" },
      { "path": "/products/2", "title": "상품 2", "description": "설명 2" }
    ]
  }'

페이지 메타 목록 조회

GET /v1/public/storages/webs/:storageID/page-metas?limit=20&offset=0

특정 경로 메타 조회

GET /v1/public/storages/webs/:storageID/page-metas/get?path=/products/123

특정 경로 메타 삭제

DELETE /v1/public/storages/webs/:storageID/page-metas?path=/products/123

전체 메타 삭제

DELETE /v1/public/storages/webs/:storageID/page-metas/all

스토리지 API

함수 API