본문으로 건너뛰기

웹 스토리지 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 — 프로덕션 배포 POST /v1/public/storages/webs/:storageID/deploy/dev — Dev 배포

보통 이 엔드포인트는 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